CLI-Tool (@auris/cli)

# Global installieren (empfohlen)
npm install -g @auris/cli
 
# Oder ohne Installation mit npx ausführen
npx @auris/cli --help

auris --version

auris login

export AURIS_DOMAIN=auth.yourdomain.com
export AURIS_CLIENT_ID=app_xxxxx
export AURIS_CLIENT_SECRET=cs_live_xxxxx
export AURIS_TENANT=my-tenant
 
auris users list

{
  "domain": "auth.yourdomain.com",
  "clientId": "app_xxxxx",
  "tenant": "my-tenant",
  "outputFormat": "table"
}

auris init

? Auris-Domain: auth.yourdomain.com
? Client-ID: app_xxxxx
? Tenant: my-tenant
? Standard-Ausgabeformat: table

.aurisrc im aktuellen Verzeichnis erstellt.

auris init --global

auris login

auris whoami

Benutzer:   Alice Smith
E-Mail:     [email protected]
ID:         usr_abc123
Rollen:     admin, editor
Tenant:     my-tenant

auris test

Verbindung zu auth.yourdomain.com... OK
Client-ID app_xxxxx... gültig
Token... gültig (läuft ab in 42 Minuten)
Alle Prüfungen bestanden.

auris applications list
auris applications list --json

ID              NAME                TYP     STATUS
app_abc123      Meine Web-App       WEB     aktiv
app_def456      Mobile App          MOBILE  aktiv
app_ghi789      Reporting-Dienst    M2M     aktiv

auris applications create
 
# Ohne Interaktion (für Skripte)
auris applications create \
  --name "Meine API" \
  --type M2M \
  --non-interactive

auris users list
auris users list --page 2 --limit 25
auris users list --role admin
auris users list --search alice

auris users get [email protected]
auris users get usr_abc123

ID:               usr_abc123
E-Mail:           [email protected]
Name:             Alice Smith
Benutzername:     alice
Rollen:           admin, editor
Status:           aktiv
E-Mail verifiz.:  ja
Erstellt:         2024-01-15T10:30:00Z
Letzte Anmeldung: 2026-02-14T09:00:00Z

# Interaktiv
auris users create
 
# Ohne Interaktion
auris users create \
  --email "[email protected]" \
  --first-name "Neuer" \
  --last-name "Benutzer" \
  --role "editor" \
  --send-invite

auris users update [email protected] --first-name "Alicia"
auris users update usr_abc123 --role editor --role viewer

auris users delete [email protected]
auris users delete [email protected] --yes

auris roles list

ID           NAME         BESCHREIBUNG                  BENUTZER
role_abc     admin        Vollständiger Admin-Zugriff   3
role_def     editor       Kann Inhalte bearbeiten       12
role_ghi     viewer       Nur-Lese-Zugriff              45

auris roles get admin
auris roles get role_abc123

auris roles create --name "abrechnungs-manager" --description "Verwaltet Abrechnung und Rechnungen"

auris permissions list
auris permissions list --role admin
auris permissions list --category billing

# Aktuelle Logs anzeigen
auris logs
 
# Nach Level filtern
auris logs --level error
 
# Nach Aktionstyp filtern
auris logs --action user.login
 
# Nach Zeitraum filtern
auris logs --since "2026-02-01T00:00:00Z" --until "2026-02-17T23:59:59Z"
 
# Logs in Echtzeit streamen (fragt alle 5 Sekunden ab)
auris logs --follow
 
# Ausgabe als JSON für Piping
auris logs --json | jq '.[] | select(.level == "error")'

# Verfügbare Templates anzeigen
auris generate --list

Verfügbare Templates:
  login-page     Login-Seite mit Auris-Button (React, Next.js, Vue, Svelte)
  callback-page  OAuth2-Callback-Handler-Seite
  middleware     Next.js / Express Auth-Middleware
  api-route      Geschützte API-Route (Next.js, Express)
  php-login      PHP-Login-Flow (login.php + callback.php + dashboard.php)

# Next.js-Login-Seite generieren
auris generate login-page --framework nextjs --output ./app/auth/login/page.tsx
 
# Express-Middleware generieren
auris generate middleware --framework express --output ./middleware/auth.js
 
# PHP-Login-Flow generieren
auris generate php-login --output ./public/

# Benutzer pro Rolle zählen
auris users list --json --limit 500 | jq '[.[].roles[]] | group_by(.) | map({rolle: .[0], anzahl: length})'
 
# Alle deaktivierten Konten finden
auris users list --json --status disabled | jq '.[] | .email'
 
# Aktuelle Fehler-Logs in eine Datei exportieren
auris logs --level error --since "2026-02-01T00:00:00Z" --json > fehler.json
 
# Test-Benutzer in einem CI-Teardown-Schritt löschen
auris users delete "test-$(echo $BUILD_ID)@example.com" --yes

auris users get "[email protected]" --quiet
if [ $? -eq 4 ]; then
  echo "Benutzer nicht gefunden, wird erstellt..."
  auris users create --email "[email protected]" --non-interactive
fi

# .github/workflows/provision-users.yml
name: Benutzer bereitstellen
 
on:
  workflow_dispatch:
 
jobs:
  provision:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
 
      - name: Node.js einrichten
        uses: actions/setup-node@v4
        with:
          node-version: '20'
 
      - name: Auris CLI installieren
        run: npm install -g @auris/cli
 
      - name: Benutzer bereitstellen
        env:
          AURIS_DOMAIN: ${{ secrets.AURIS_DOMAIN }}
          AURIS_CLIENT_ID: ${{ secrets.AURIS_CLIENT_ID }}
          AURIS_CLIENT_SECRET: ${{ secrets.AURIS_CLIENT_SECRET }}
          AURIS_TENANT: ${{ secrets.AURIS_TENANT }}
        run: |
          auris users create \
            --email "[email protected]" \
            --first-name "Deploy" \
            --last-name "Bot" \
            --role "ci-runner" \
            --non-interactive

#!/bin/bash
# provision-tenant.sh
set -e
 
export AURIS_DOMAIN="auth.yourdomain.com"
export AURIS_CLIENT_ID="app_xxxxx"
export AURIS_CLIENT_SECRET="$CI_AURIS_SECRET"
export AURIS_TENANT="my-tenant"
 
echo "Rollen erstellen..."
auris roles create --name "abrechnungs-admin" --description "Verwaltet Abrechnung"
auris roles create --name "berichts-viewer" --description "Nur-Lese-Zugriff auf Berichte"
 
echo "Initialen Admin-Benutzer erstellen..."
auris users create \
  --email "[email protected]" \
  --first-name "Admin" \
  --last-name "Benutzer" \
  --role "admin" \
  --send-invite \
  --non-interactive
 
echo "Fertig."