keenauth_permission

La risorsa keenauth_permission definisce un'autorizzazione (uno scope OAuth) di un'API, con i testi che mostra la schermata di consenso. Il provider non gestisce l'API stessa: passa l'ID di un'API esistente come api_id. Inserisci l'autorizzazione in un ruolo con keenauth_role.

resource "keenauth_permission" "invoices_read" {
  api_id       = "api_01j9zq3v8c5m2x7k4t6r1n0b3d"
  value        = "invoices:read"
  display_name = "Read invoices"
  description  = "See the invoices of the account."
  sensitivity  = "normal"

  consent_text_i18n = {
    de = "Rechnungen ansehen"
    tr = "Faturaları görüntüle"
  }
}

Ciclo di vita

• value ha la forma resource:action e compare nel claim permissions dei token di accesso. È univoco nell'API e non può essere modificato: un nuovo valore sostituisce l'autorizzazione. Il prefisso idp_ appartiene all'API di sistema.
• display_name, description e i testi in consent_text_i18n sono testo semplice: niente caratteri di controllo, niente separatori di riga o paragrafo, niente caratteri di override bidirezionale e, per display_name e description, niente spazi iniziali o finali (l'API rimuove quelli dai due campi). Un testo in consent_text_i18n viene memorizzato come scritto, ma non può essere vuoto. Un testo vuoto non è ammesso; rimuovi invece l'attributo.
• consent_text_i18n viene sostituita per intero come mappa. Le chiavi sono tag di lingua come de o pt-BR; al massimo 30 lingue. Rimuovi l'attributo per svuotarla.
• sensitivity è normal o sensitive; un'autorizzazione sensibile viene evidenziata nella schermata di consenso.
• Una riga di autorizzazione non ha versione, quindi l'API non offre un controllo If-Match per essa. Il provider legge la lista delle autorizzazioni dell'API a ogni plan, mostra come drift ogni modifica fatta altrove e invia solo i campi modificati.
• Rimuovere la risorsa elimina l'autorizzazione e la rimuove da ogni ruolo e dalle liste di autorizzazioni delle applicazioni. Il successivo refresh di quei ruoli mostra la modifica.
• L'API di sistema non accetta nuove autorizzazioni e le sue autorizzazioni non possono essere eliminate (409 conflict). Un'API contiene al massimo 1.000 autorizzazioni.
• Un'autorizzazione eliminata al di fuori del provider viene rimossa dallo state e pianificata di nuovo.

Import

Importa tramite ID dell'API e ID dell'autorizzazione, oppure tramite ID dell'API e valore:

tofu import keenauth_permission.invoices_read api_01j9zq3v8c5m2x7k4t6r1n0b3d/perm_01j9zq3v8c5m2x7k4t6r1n0b3e
tofu import keenauth_permission.invoices_read api_01j9zq3v8c5m2x7k4t6r1n0b3d/invoices:read