https://github.com/jpbede/loki-auth-proxy

Stateless Grafana Loki multi tenant authentication proxy
https://github.com/jpbede/loki-auth-proxy

go golang grafana grafana-loki loki

Last synced: 8 days ago
JSON representation

Stateless Grafana Loki multi tenant authentication proxy

• Host: GitHub
• URL: https://github.com/jpbede/loki-auth-proxy
• Owner: jpbede
• License: mit
• Created: 2021-04-01T17:24:17.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2023-02-15T02:33:51.000Z (over 1 year ago)
• Last Synced: 2024-09-26T08:10:13.458Z (about 1 month ago)
• Topics: go, golang, grafana, grafana-loki, loki
• Language: Go
• Homepage:
• Size: 123 KB
• Stars: 12
• Watchers: 3
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Grafana Loki - Stateless multi tenant authentication proxy

[![PkgGoDev](https://pkg.go.dev/badge/go.bnck.me/loki-auth-proxy)](https://pkg.go.dev/go.bnck.me/loki-auth-proxy)

[![Codacy Badge](https://app.codacy.com/project/badge/Grade/a7da697dfae94a39bb74394ccf472df7)](https://www.codacy.com/gh/jpbede/loki-auth-proxy/dashboard)

[![codecov](https://codecov.io/gh/jpbede/loki-auth-proxy/branch/main/graph/badge.svg?token=g6JohOjiZm)](https://codecov.io/gh/jpbede/loki-auth-proxy)

Stateless multi tenant authentication proxy, that handles authentication and setting `X-Scope-OrgID` for Grafana Loki.

**Please be nice to me, the project is work in progress :)**

## Requirements

To use this, Grafana Loki needs to be configured in multi tenant mode with `auth_enabled: true` as described in the [official docs](https://grafana.com/docs/loki/latest/operations/multi-tenancy/).

## Installing

### Binaries

You will find pre-compiled binaries and packages for the most common OS under the [releases](https://github.com/jpbede/loki-auth-proxy/releases).

### Docker

```shell

docker run -v $(pwd)/loki-auth-proxy.yml:/etc/loki-auth-proxy.yml -v $(pwd)/loki-auth.yml:/etc/loki-auth.yml -p 8081:8081 ghcr.io/jpbede/loki-auth-proxy:latest

```

or via `docker-compose.yml`

```yaml

version: "3"

services:

  auth-proxy:

    image: ghcr.io/jpbede/loki-auth-proxy:latest

    ports:

      - 8081:8081

    volumes:

      - "/etc/loki-auth-proxy.yml:/etc/loki-auth-proxy.yaml"

      - "/etc/loki-auth.yml:/etc/loki-auth.yml"

```

### macOS

Simply use `homebrew` (https://brew.sh/)

To install `loki-auth-proxy` use following command `brew install jpbede/tap/loki-auth-proxy`

## Using it

An example configuration you can find at [example/loki-auth-proxy.yaml](example/loki-auth-proxy.yaml).