DocumentazioneAdobe PassAutenticazione Adobe Pass

Recupera credenziali client retrieve-client-credentials

Last update: Tue Sep 24 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
Il contenuto di questa pagina viene fornito solo a scopo informativo. L’utilizzo di questa API richiede una licenza corrente di Adobe. Non è consentito alcun uso non autorizzato.
IMPORTANT
L'implementazione dell'API Dynamic Client Registration è limitata dalla documentazione del meccanismo di limitazione.

Richiesta request

HTTP
percorso
/o/client/register
metodo
POST
Parametri corpo
software_statement
L'istruzione software associata all'applicazione registrata creata e scaricata da Adobe Pass TVE Dashboard.

La gestione delle applicazioni registrate è descritta nella documentazione Panoramica sulla registrazione dei client dinamici.
obbligatorio
redirect_uri
L’URI di reindirizzamento associato alla posizione in cui si sposta l’agente utente al termine del flusso di autenticazione.
facoltativo
Intestazioni
Content-Type
Tipo di file multimediale accettato per le risorse inviate.

Deve essere application/json.
obbligatorio
X-Device-Info
La generazione del payload di informazioni sul dispositivo è descritta nella documentazione di X-Device-Info.

Si consiglia vivamente di utilizzarlo sempre quando la piattaforma del dispositivo dell’applicazione consente di fornire esplicitamente valori validi.

Se fornito, il backend di autenticazione di Adobe Pass unirà in modo esplicito i valori con quelli estratti in modo implicito (per impostazione predefinita).

Se non viene fornito, il backend di autenticazione Adobe Pass utilizzerà i valori estratti in modo implicito (per impostazione predefinita).
obbligatorio
Accetta
Tipo di supporto accettato dall'applicazione client.

Se specificato, deve essere application/json.
facoltativo
User-Agent
Agente utente dell’applicazione client.
facoltativo

Risposta response

Completato success

Intestazioni
Stato
201
obbligatorio
Content-Type
application/json
obbligatorio
Corpo

Oggetto JSON con i seguenti attributi:

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff 9-bgcolor-deebff 13-bgcolor-deebff 17-bgcolor-deebff 21-bgcolor-deebff 25-bgcolor-deebff layout-auto html-authored
Attributo
client_id Stringa dell'identificatore dell'applicazione client. obbligatorio
client_secret Stringa segreta dell'applicazione client. obbligatorio
client_id_issue_at Ora in cui è stato emesso l’identificatore dell’applicazione client. obbligatorio
redirect_uris Matrice di stringhe URI di reindirizzamento che l'applicazione client può utilizzare nei flussi basati su reindirizzamento. obbligatorio
grant_types Stringhe del tipo di concessione che l’applicazione client può utilizzare per l’endpoint del token client. obbligatorio
ambiti Le stringhe di ambito che definiscono le API di autenticazione di Adobe Pass che l’applicazione client può utilizzare. obbligatorio
obbligatorio

Errore error

Intestazioni
Stato
400
obbligatorio
Content-Type
application/json
obbligatorio
Corpo
errore

I valori possibili sono:

table 0-row-3 1-row-2 2-row-2 3-row-2 4-row-2 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff 8-bgcolor-deebff 11-bgcolor-deebff 14-bgcolor-deebff layout-auto html-authored
Valore
invalid_request

La richiesta non è valida per uno dei motivi seguenti:

  • Nella richiesta manca un parametro obbligatorio.
  • La richiesta include un valore di parametro non supportato.
  • La richiesta ripete un parametro.
  • Richiesta non valida.
invalid_redirect_uri La richiesta include un valore non valido per l’URI di reindirizzamento.
invalid_software_statement La richiesta include un valore per l'istruzione software non valido.
unauthorized_software_statement La richiesta include un valore per l'istruzione software che non è approvata per l'utilizzo da parte del server di autenticazione di Adobe Pass.
obbligatorio

Esempi samples

Recupera credenziali client samples-retrieve-client-credentials

Richiesta
code language-https 
POST /o/client/register HTTP/1.1

    X-Device-Info: ewoJInByaW1hcnlIYXJkd2FyZVR5cGUiOiAiU2V0VG9wQm94IiwKCSJtb2RlbCI6ICJUViA1dGggR2VuIiwKCSJtYW51ZmFjdHVyZXIiOiAiQXBwbGUiLAoJIm9zTmFtZSI6ICJ0dk9TIgoJIm9zVmVuZG9yIjogIkFwcGxlIiwKCSJvc1ZlcnNpb24iOiAiMTEuMCIKfQ==
    Content-Type: application/json
    Accept: application/json
    User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)

{
    "software_statement": "eyJhbGciOiJSUzI1NiJ9.
        eyJzb2Z0d2FyZV9pZCI6IjROUkIxLTBYWkFCWkk5RTYtNVNNM1IiLCJjbGll
        bnRfbmFtZSI6IkV4YW1wbGUgU3RhdGVtZW50LWJhc2VkIENsaWVudCIsImNs
        aWVudF91cmkiOiJodHRwczovL2NsaWVudC5leGFtcGxlLm5ldC8ifQ.
        GHfL4QNIrQwL18BSRdE595T9jbzqa06R9BT8w409x9oIcKaZo_mt15riEXHa
        zdISUvDIZhtiyNrSHQ8K4TvqWxH6uJgcmoodZdPwmWRIEYbQDLqPNxREtYn0
        5X3AR7ia4FRjQ2ojZjk5fJqJdQ-JcfxyhK-P8BAWBd6I2LLA77IG32xtbhxY
        fHX7VhuU5ProJO8uvu3Ayv4XRhLZJY4yKfmyjiiKiPNe-Ia4SMy_d_QSWxsk
        U5XIQl5Sa2YRPMbDRXttm2TfnZM1xx70DoYi8g6czz-CPGRi4SW_S2RKHIJf
        IjoI3zTJ0Y2oe0_EJAiXbL6OyF9S5tKxDXV8JIndSA",
    "redirect_uri": "adobepass://com.programmer"
 }
Risposta - Completata
code language-https 
HTTP/1.1 201 Created

Content-Type: application/json;charset=UTF-8

{
    "client_id": "s6BhdRkqt3",
    "client_secret": "t7AkePiru4",
    "redirect_uris": [
        "app://com.programmer.adobe#sdasdsadas"
    ],
    "grant_types": [
        "client_credentials"
    ],
    "scopes": [
        "api:client:v2"
    ],
    "client_id_issued_at": 1723227212
}
Risposta - Errore
code language-https 
HTTP/1.1 400 Bad Request

Content-Type: application/json;charset=UTF-8

{ "error": "invalid_request" }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b