Registra un'app senza scheda
RFC 7591, aperta: un'app di cui nessuna scheda risponde. La pagina di consenso la dice non verificata, e sparisce 30 giorni dopo la registrazione.
/oidc/register- Accesso
- Crea dati temporanei
- Client
- Client locale o server
Corpo JSON#
| Nome | Posizione | Significato |
|---|---|---|
redirect_urisObbligatorio | JSON | Da 1 a 10: https, o http sull'interfaccia di loopback. |
client_nameObbligatorio | JSON | Da 1 a 60 caratteri; non può dire Veil. |
token_endpoint_auth_method | JSON | client_secret_basic (predefinito), private_key_jwt o none. |
grant_types, response_types | JSON | authorization_code (e refresh_token); code. |
id_token_signed_response_alg | JSON | EdDSA (predefinito) o ES256. |
jwks | JSON | Con private_key_jwt: da 1 a 8 chiavi pubbliche. jwks_uri e logo_uri non si leggono. |
Esempi di richiesta#
curl -fsS --json '{"client_name":"CLI notes","redirect_uris":["http://127.0.0.1/callback"],"token_endpoint_auth_method":"none"}' 'https://veil.rip/oidc/register'Risposta#
201 con i metadati tenuti, e client_secret una volta.
| Campo | Tipo | Significato |
|---|---|---|
client_id | string | veil_app_ e 32 caratteri hex. |
client_secret | string | Per client_secret_basic, una volta. |
client_id_issued_at, client_secret_expires_at, veil_expires_at | integer | Secondi Unix; l'app finisce a veil_expires_at. |
redirect_uris, client_name, client_uri, token_endpoint_auth_method, grant_types, response_types, id_token_signed_response_alg, post_logout_redirect_uris, jwks, application_type, scope | mixed | I metadati come sono stati tenuti. |
Intestazioni della risposta#
| Intestazione | Valore | Significato |
|---|---|---|
Content-Type | application/json | JSON, anche per gli errori. |
Cache-Control | no-store | Privata: mai in una cache. |
Note d’uso#
- Gli errori di questo endpoint seguono OAuth:
{"error", "error_description"}(RFC 6749, 5.2), non l'oggettoerrordel resto delle API. Un limite risponde comunque 429 con la busta solita. - Dieci registrazioni all'ora per IP.
Errori#
Gli errori API restituiscono un oggetto error. Usa error.code nella logica del programma; error.message è un testo inglese per le persone e può cambiare. Guida a risposte ed errori
| HTTP | Codice | Significato e cosa fare |
|---|---|---|
| 400 | invalid_client_metadata | Errore OAuth: un campo della registrazione manca o non è ammesso (nome, sito, grant type, response type, algoritmo del token ID, jwks). Leggi |
| 400 | invalid_redirect_uri | Errore OAuth: un redirect URI non è https, o è http fuori dall'interfaccia di loopback, o ha un frammento o informazioni utente. Registra URI https esatti, o http://127.0.0.1/… per un'app nativa. |
| 404 | invalid_request | Errore OAuth: Accedi con Veil non è configurato su questo server. Usa https://veil.rip, o un server il cui documento di discovery risponde. |
| 503 | temporarily_unavailable | Errore OAuth: in questo momento ci sono troppe app registrate senza scheda. Registra l'app da /developers, con una scheda. |
Errori comuni delle richieste
| HTTP | Codice | Significato e cosa fare |
|---|---|---|
| 429 | rate_limited | È stato superato un limite anonimo, delle richieste firmate o della chiave API. Attendi almeno i secondi indicati da |
| 500 | internal_error | Si è verificato un errore imprevisto del server. I dettagli interni non vengono restituiti. Riprova le letture con attese crescenti e un limite. Controlla l’esito delle scritture prima di inviare una nuova operazione firmata. |
| 503 | busy | L’applicazione ha raggiunto un limite temporaneo di concorrenza o del database. Attendi i secondi indicati da |