--- sourceDocument: Référence de l’API Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Référence de l’API Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Utiliser un fournisseur OAuth tiers # Utiliser un fournisseur OAuth tiers {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes de lecture Chaque application cliente doit s'inscrire auprès de l'instance pour participer à l'autorisation OAuth. ## Avant de commencer Rôle requis : administrateur ## Pourquoi et quand exécuter cette tâche Remarque : ServiceNow ne prend en charge que les fournisseurs OAuth tiers pour autoriser les demandes à partir d'API ServiceNow tierces. Par exemple, vous pouvez intégrer un service de calendrier tiers qui nécessite des jetons d'accès OAuth 2.0 pour lire les événements planifiés d'un utilisateur et créer des événements. Configurez le service Calendar en tant que fournisseur OAuth tiers. Cette configuration vous permet d'obtenir un jeton d'accès à partir du service de calendrier, puis d'utiliser le jeton pour effectuer des requêtes sur le service à partir de ServiceNow. ## Procédure 1. Accédez à la ToutOAuth systèmeRegistre d'application , puis cliquez sur Nouveau. 2. Sur la page de l'intercepteur, cliquez sur Se connecter à un fournisseur OAuth tiers , puis renseignez le formulaire. {#t_UseAThirdPartyOAuthProvider__table_sgc_qqv_yq__entry__2} | Champ | Description | |-|-| | Nom | Un nom unique qui identifie l'application à accéder. | | ID client | ID unique de l'application. L'instance utilise l'ID client lors de la demande d'un jeton d'accès. Vous devez obtenir l'ID client auprès du serveur d'autorisation. | | Secret client | \[Obligatoire\] Chaîne secrète partagée que l'instance et l'application utilisent pour autoriser les communications l'une avec l'autre. Si vous ne saisissez pas le bon secret client, les jetons ne sont pas émis. | | Script de l'API OAuth | Cette option vous permet de référencer un include de script OAuthUtil modifié. Copiez et renommez le fichier d'include de script OAuthUtil par défaut, puis modifiez cette version pour obtenir des demandes et des réponses spécifiques afin qu'elles correspondent à votre fournisseur OAuth tiers. Le nom de script modifié doit avoir le préfixe OAuth. Consultez [OAuthUtil](https://servicenow-prod.fluidtopics.net/RaD5Z6uC2Ly4c1AvJOjo_Q#c_OAuthUtilScriptInclude "L’include de script OAuthUtil modifie les paramètres de demande et analyse la réponse du jeton pendant l’exécution.") pour ajouter le paramètre body requis dans la méthode appropriée. | | URL du logo | URL qui contient une image à utiliser comme logo de l'application. | | Type d'accord par défaut | Le type de subvention : * Code d'autorisation : Code qui est accordé au client pour obtenir un jeton d'accès, qui est ensuite utilisé pour obtenir l'accès à la ressource. Si vous sélectionnez cette option, vous avez besoin d'une URL d'autorisation (l'URL du serveur d'autorisation). * Informations d'identification du mot de passe du propriétaire de la ressource : nom d'utilisateur et mot de passe de l'utilisateur qui tente d'obtenir l'accès à la ressource. * Informations d'identification du client : l'ID et le secret du client, qui sont tous deux utilisés pour obtenir le jeton d'accès. Cette méthode ne fournit pas de jetons d'actualisation. * Support JWT : un serveur d'autorisation valide un jeton JWT qui permet de partager des informations d'identité et de sécurité entre les domaines de sécurité. * Support SAML2 : génère l'assertion SAML2, puis échange l'assertion contre les jetons d'accès avec le fournisseur. Remarque : Pour la demande SuccessFactors sortante, utilisez le support SAML2 comme type d'accord par défaut. {#t_UseAThirdPartyOAuthProvider__ul_ln4_4pg_nwb} | | Durée de vie du jeton d'actualisation | Durée de vie du jeton d'actualisation en secondes. | | Accessible depuis | Le périmètre de l'application à partir duquel ce registre est accessible. | | Actif | Case à cocher qui indique que le registre d'application est actif. | | URL d'autorisation | Si vous utilisez le type d'accord de code d'autorisation, l'URL du point de terminaison pour autoriser l'utilisateur. Si vous accédez à une autre ServiceNow instance, ajoutez `/oauth_auth.do` à l'URL. | | URL de jeton | Emplacement du point de terminaison de jeton que l'instance utilise pour récupérer et actualiser les jetons. Si vous accédez à une autre ServiceNow instance, ajoutez `/oauth_token.do` à l'URL. | | URL de redirection | Le point de terminaison de l'application qui reçoit le code d'autorisation. Laissez le champ vide pour que l'instance génère automatiquement l'URL. Si vous accédez à une autre ServiceNow instance, ajoutez `/oauth_redirect.do` à l'URL. | | URL de révocation du jeton | L'emplacement du point de terminaison que l'instance utilise pour révoquer le jeton. Si vous accédez à une autre instance, ajoutez `/oauth_revoke.do` à l'URL. | | Commentaires | Informations supplémentaires à associer à l'application. | | Listes incorporées || | Profils des entités OAuth | Les profils associés au fournisseur OAuth. Le profil comprend le type de subvention. Cliquez sur le nom du profil pour accéder au [formulaire Profil de l'entité OAuth](https://servicenow-prod.fluidtopics.net/Owp2cHosmD3~2l8RpUC8AQ "Un profil OAuth inclut le type d’accord dont le fournisseur OAuth tiers a besoin pour obtenir l’accès à la ressource restreinte."). | | Périmètres des entités OAuth | Périmètres de l'entité associés au fournisseur OAuth. Le champ d'application identifie les services auxquels l'application a accès. Cliquez sur le nom du champ d'application pour accéder au [formulaire Périmètre de l'entité OAuth](https://servicenow-prod.fluidtopics.net/vny6bGDjcl6BwRlHlhFQmg "Spécifiez les étendues OAuth que vous obtenez du fournisseur. Les champs d’application peuvent être n’importe quel niveau d’accès spécifié par le fournisseur, tel que la lecture, l’écriture ou toute chaîne, y compris une URL."). | [ ] {#t_UseAThirdPartyOAuthProvider__table_sgc_qqv_yq} 3. Cliquez sur Envoyer. L'enregistrement est enregistré dans la table Registres d'application \[oauth_entity\]. Le système crée un enregistrement dans la table Registres d'application \[oauth_entity\] de type Fournisseur OAuth. L'instance génère également automatiquement un profil par défaut à l'aide du type d'attribution spécifié, mais sans aucune portée. ## Que faire ensuite Vous pouvez [créer des profils supplémentaires](https://servicenow-prod.fluidtopics.net/Owp2cHosmD3~2l8RpUC8AQ "Un profil OAuth inclut le type d’accord dont le fournisseur OAuth tiers a besoin pour obtenir l’accès à la ressource restreinte."), chacun avec des champs d'application. * **[Profils et périmètres OAuth](https://servicenow-prod.fluidtopics.net/RQSDGmJynYJm3ChZtL7nCA)** Dans le scénario du fournisseur OAuth, les profils et les champs d'application spécifient le type d'accord, le type d'autorisation et le niveau d'accès.