Strumento CLI (@auris/cli)

# Installazione globale (consigliata)
npm install -g @auris/cli
 
# Oppure esegui senza installare con npx
npx @auris/cli --help

auris --version

auris login

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

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

auris init

? Dominio Auris: auth.tuodominio.com
? Client ID: app_xxxxx
? Tenant: my-tenant
? Formato di output predefinito: table

Creato .aurisrc nella directory corrente.

auris init --global

auris login

# Specifica un tenant al momento del login
auris login --tenant my-tenant

auris whoami

Utente:  Alice Smith
Email:   [email protected]
ID:      usr_abc123
Ruoli:   admin, editor
Tenant:  my-tenant

auris test

Connessione a auth.tuodominio.com... OK
Client ID app_xxxxx... valido
Token... valido (scade tra 42 minuti)
Tutti i controlli superati.

auris applications list
auris applications list --json

ID              NOME                    TIPO    STATO
app_abc123      La Mia Web App          WEB     attivo
app_def456      App Mobile              MOBILE  attivo
app_ghi789      Servizio Reporting      M2M     attivo

auris applications create

? Nome applicazione: La Mia Nuova App
? Tipo applicazione: WEB
? URL di callback: http://localhost:3000/callback
? URL di logout consentito: http://localhost:3000

Applicazione app_newxxx creata.
Client ID: app_newxxx

auris applications create \
  --name "La Mia 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

EMAIL                   NOME          RUOLI       STATO
[email protected]       Alice Smith   admin        abilitato
[email protected]         Bob Jones     editor       abilitato
[email protected]     Charlie Lee   subscriber   disabilitato

auris users get [email protected]
auris users get usr_abc123

ID:               usr_abc123
Email:            [email protected]
Nome:             Alice Smith
Username:         alice
Ruoli:            admin, editor
Stato:            abilitato
Email verificata: sì
Creato:           2024-01-15T10:30:00Z
Ultimo accesso:   2026-02-14T09:00:00Z

# Interattivo
auris users create
 
# Non interattivo
auris users create \
  --email "[email protected]" \
  --first-name "Nuovo" \
  --last-name "Utente" \
  --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           NOME         DESCRIZIONE                  UTENTI
role_abc     admin        Accesso amministrativo pieno     3
role_def     editor       Può modificare i contenuti       12
role_ghi     viewer       Accesso in sola lettura          45

auris roles get admin
auris roles get role_abc123

auris roles create --name "billing-manager" --description "Gestisce fatturazione e pagamenti"

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

# Mostra log recenti
auris logs
 
# Filtra per livello
auris logs --level error
 
# Filtra per tipo di azione
auris logs --action user.login
 
# Filtra per intervallo di tempo
auris logs --since "2026-02-01T00:00:00Z" --until "2026-02-17T23:59:59Z"
 
# Trasmetti log in tempo reale (polling ogni 5 secondi)
auris logs --follow
 
# Output come JSON per il piping
auris logs --json | jq '.[] | select(.level == "error")'

# Elenca i template disponibili
auris generate --list

Template disponibili:
  login-page     Pagina di login con pulsante Auris (React, Next.js, Vue, Svelte)
  callback-page  Handler pagina callback OAuth2
  middleware     Middleware auth Next.js / Express
  api-route      Handler route API protetta (Next.js, Express)
  php-login      Flusso di login PHP (login.php + callback.php + dashboard.php)

# Genera una pagina di login Next.js
auris generate login-page --framework nextjs --output ./app/auth/login/page.tsx
 
# Genera un middleware Express
auris generate middleware --framework express --output ./middleware/auth.js
 
# Genera il flusso di login PHP
auris generate php-login --output ./public/

# Conta utenti per ruolo
auris users list --json --limit 500 | jq '[.[].roles[]] | group_by(.) | map({role: .[0], count: length})'
 
# Trova tutti gli account disabilitati
auris users list --json --status disabled | jq '.[] | .email'
 
# Esporta i log di errore recenti in un file
auris logs --level error --since "2026-02-01T00:00:00Z" --json > errori.json
 
# Elimina un utente di test in un passo di teardown CI
auris users delete "test-$(echo $BUILD_ID)@example.com" --yes

auris users get "[email protected]" --quiet
if [ $? -eq 4 ]; then
  echo "Utente non trovato, creazione in corso..."
  auris users create --email "[email protected]" --non-interactive
fi

# .github/workflows/provision-users.yml
name: Provisioning utenti
 
on:
  workflow_dispatch:
 
jobs:
  provision:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
 
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
 
      - name: Installa Auris CLI
        run: npm install -g @auris/cli
 
      - name: Provisioning utenti
        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.tuodominio.com"
export AURIS_CLIENT_ID="app_xxxxx"
export AURIS_CLIENT_SECRET="$CI_AURIS_SECRET"
export AURIS_TENANT="my-tenant"
 
echo "Creazione ruoli..."
auris roles create --name "billing-admin" --description "Gestisce la fatturazione"
auris roles create --name "report-viewer" --description "Accesso in sola lettura ai report"
 
echo "Creazione utente admin iniziale..."
auris users create \
  --email "[email protected]" \
  --first-name "Admin" \
  --last-name "Utente" \
  --role "admin" \
  --send-invite \
  --non-interactive
 
echo "Completato."