Référence de l’API REST (héritée) rest-api-reference
Mécanisme de limitation
L’API REST d’authentification Adobe Pass est régie par un mécanisme de limitation.
Formats de réponse response-formats
- Définissez l’en-tête HTTP Accept sur
application/xmlouapplication/json. - Dans la payload de la requête, spécifiez le paramètre
format=xmlouformat=json. - Appelez le point d’entrée du service web avec l’extension
.xmlou.json. Par exemple,/regcode.xmlou/regcode.json
Points d’entrée de l’API REST clientless-endpoints
<REGGIE_FQDN> :
- Production - api.auth.adobe.com
- Évaluation - api.auth-staging.adobe.com
<SP_FQDN> :
- Production - api.auth.adobe.com
- Évaluation - api.auth-staging.adobe.com
Résumé des services web web_srvs_summary
Le tableau ci-dessous répertorie les services web disponibles pour l’approche sans client. Cliquez sur les points d’entrée des services web pour plus d’informations (exemple de requête et de réponse, paramètres d’entrée, méthodes HTTP, etc.)
| Sr | Point d’entrée de service web | Description | . | Hébergé à | Appelé par |
|-----|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------|-----------------------------------------------------------|-----------------------------|
| 1. | <REGGIE_FQDN>/reggie/v1/
{requestorId}/regcode | Renvoie le code d’enregistrement et l’URI de page de connexion générés de manière aléatoire | 2 | Service Adobe
Reg Code) | Smart Device |
| 2. | <REGGIE_FQDN>/reggie/v1/
{requestorId}/regcode/
{registrationCode} | Retourne l’enregistrement du code d’enregistrement contenant l’UUID du code d’enregistrement, le code d’enregistrement et l’ID de périphérique haché | 8 | Service Adobe
Reg Code) | Authentification Adobe Pass |
| 3. | <SP_FQDN>/api/v1/config/
{requestorId} | Renvoie la liste des fichiers MVPD configurés pour le demandeur | 5 | Adobe
Adobe Pass
authentication
Service | Connexion
Web
App |
| 4. | <SP_FQDN>/api/v1/authenticate | Lance le processus AuthN en informant l’événement de sélection MVPD. Crée un enregistrement sur la base de données d’authentification, qui est réconcilié lorsqu’une réponse réussie est reçue de MVPD (étape 13) | 7 | Adobe
Adobe Pass
authentication
Service | Connexion
Web
App |
| 5. | Consommateur d’assertions SAML | Workflow SAML existant entre l’authentification Adobe Pass et MVPD | 13 | Adobe Pass
authentication
Service | Authentification Adobe Pass |
| 6. | <SP_FQDN>/api/v1/checkauthn/
{registrationCode} | L’application Web de connexion peut vérifier si le flux de connexion a réussi | | Adobe Pass
authentication
Service | Connexion
Web
App |
| 7. | <SP_FQDN>/api/v1/tokens/authn | Obtient les métadonnées liées au jeton AuthN | 15 | Adobe Pass
authentication
Service | Smart Device |
| 8. | <REGGIE_FQDN>/reggie/v1/
{requestorId}/regcode/
{registrationCode} | Supprime l’enregistrement du code rég. et libère le code rég. pour réutilisation | 16 | Service Adobe
Reg Code) | Authentification Adobe Pass |
| 9. | <SP_FQDN>/api/v1/authorize | Obtient la réponse d’autorisation. | 17 | Adobe Pass
authentication
Service | Smart Device |
| 10. | <SP_FQDN>/api/v1/checkauthn | Indique si l’appareil possède un jeton AuthN non expiré. | | Adobe Pass
authentication
Service | Smart Device |
| 11. | <SP_FQDN>/api/v1/tokens/authn | Renvoie le jeton AuthN s’il est trouvé. | | Adobe Pass
authentication
Service | Smart Device |
| 12. | <SP_FQDN>/api/v1/tokens/authz | Renvoie le jeton AuthZ s’il est trouvé. | | Adobe Pass
authentication
Service | Smart Device |
| 13. | <SP_FQDN>/api/v1/tokens/media | Renvoie le jeton de média court s’il est trouvé - identique à /api/v1/mediatoken | | Adobe Pass
authentication
Service | Smart Device |
| 14. | <SP_FQDN>/api/v1/mediatoken | Obtient un jeton de média court | | Adobe Pass
authentication
Service | Smart Device |
| 15. | <SP_FQDN>/api/v1/preauthorize | Récupère la liste des ressources préautorisées | | Adobe Pass
authentication
Service | Smart Device |
| 16. | <SP_FQDN>/api/v1/preauthorize/{code} | Récupère la liste des ressources préautorisées | | Adobe Pass
authentication
Service | Application Web de connexion |
| 17. | <SP_FQDN>/api/v1/logout | Supprimer les jetons AuthN et AuthZ du stockage | | Adobe Pass
authentication
Service | Smart Device |
| 18. | <SP_FQDN>/api/v1/tokens/usermetadata | Obtient les métadonnées de l’utilisateur une fois le flux d’authentification terminé | S/O | S/O | Smart Device |
| 19. | <SP_FQDN>/api/v1/authenticate/freepreview | Créer un jeton d’authentification pour la passe temporaire ou la passe temporaire promotionnelle | S/O | Adobe Pass
authentication
Service | Smart Device |
Sécurité de l’API REST security
Toutes les API REST d’authentification Adobe Pass doivent être appelées à l’aide du protocole HTTPS pour une communication sécurisée. En outre, la plupart des API appelées doivent contenir un jeton d’accès obtenu, comme décrit dans la documentation de l’API Récupérer le jeton d’accès .