Cette page explique comment configurer l'authentification et les autorisations avant de créer le data store Zendesk.
Activer l'accès par jeton
Pour permettre à Zendesk de s'authentifier et d'interagir avec votre instance Zendesk, vous devez activer l'accès par jeton. Pour activer l'accès aux jetons :
- Accédez à votre instance Zendesk et connectez-vous avec un compte administrateur.
- Dans le menu de navigation, développez Applications et intégrations, puis sélectionnez Configuration de l'API dans API.
- Cochez la case Autoriser l'accès au jeton d'API.
- Cliquez sur Enregistrer.
Configurer l'authentification et les autorisations
Pour une intégration sécurisée à l'aide d'OAuth 2.0, vous devez enregistrer votre application dans Zendesk afin d'obtenir l'ID client et le code secret du client nécessaires.
Créer un client OAuth et obtenir des identifiants d'authentification
Pour créer un client OAuth dans Zendesk et obtenir les identifiants d'authentification, procédez comme suit :
Accédez à votre instance Zendesk et connectez-vous avec un compte administrateur.
Cliquez sur l'icône Produits Zendesk, puis sélectionnez Centre d'administration.
Centre d'administration Zendesk Dans le menu de navigation, développez Applications et intégrations, puis sélectionnez Clients OAuth dans API.
Cliquez sur Ajouter un client OAuth.
Saisissez les informations suivantes sur le client :
- Nom : saisissez un nom descriptif pour votre application.
- Facultatif : Description : saisissez une brève description.
- Facultatif : Entreprise : saisissez le nom de votre entreprise.
- Facultatif : Logo : fournissez un logo qui s'affichera sur l'écran de consentement.
- Identifiant unique (ID client) : indiquez un nom unique pour votre client. Vous pouvez modifier la suggestion initiale, mais elle doit être unique.
- Type de client : sélectionnez Public pour les applications s'exécutant dans un navigateur ou sur un appareil mobile, ou Confidentiel pour les applications s'exécutant sur des serveurs sécurisés.
- URL de redirection (obligatoire) : saisissez
https://vertexaisearch.cloud.google.com/oauth-redirect. Il s'agit de l'URL vers laquelle Zendesk redirige l'utilisateur après l'autorisation, en recevant le code d'autorisation.
Cliquez sur Enregistrer pour obtenir la code secret du client.
- ID client : valeur du champ Identifiant unique.
- Code secret du client : un nouveau champ Secret s'affiche. Copiez ce secret et enregistrez-le immédiatement dans un emplacement sécurisé. Pour des raisons de sécurité, la clé secrète complète n'est affichée qu'une seule fois. Si vous la perdez, vous devez la régénérer.
Identifiants client générés Cliquez à nouveau sur Enregistrer pour finaliser les modifications.
Configurer les autorisations
Pour configurer les autorisations requises, procédez comme suit :
- Accédez à votre instance Zendesk et connectez-vous avec un compte administrateur.
- Cliquez sur l'icône Produits Zendesk, puis sélectionnez Centre d'administration.
- Dans le menu de navigation, développez Applications et intégrations, puis sélectionnez Clients OAuth dans Connexions.
- Cliquez sur Add client (Ajouter un client).
Saisissez les informations suivantes sur le client :
- Nom : saisissez un nom descriptif. Ce paramètre ne peut pas être modifié.
- Type d'octroi OAuth : sélectionnez Code d'autorisation.
- ID client : saisissez l'ID client obtenu dans la section Créer un client OAuth dans Zendesk.
- Code secret du client : saisissez la valeur du code secret du client obtenue dans la section Créer un client OAuth dans Zendesk.
- URL d'autorisation : le point de terminaison d'autorisation est généralement au format
https://<var>your-subdomain</var>.zendesk.com/oauth/authorize. Remplacez<var>your-subdomain</var>par votre sous-domaine Zendesk. - URL du jeton : le point de terminaison du jeton est généralement au format
https://<var>your-subdomain</var>.zendesk.com/oauth/token. Remplacez<var>your-subdomain</var>par votre sous-domaine Zendesk.
Ajouter des niveaux d'accès - Niveaux d'accès : saisissez les niveaux d'accès suivants, séparés par des espaces, en fonction de votre mode de connexion :
Mode de connexion Champ d'application Objectif Consentement de l'administrateur requis Recherche unifiée read,users:readPermet d'effectuer des recherches dans les données Zendesk. Non Cliquez sur Enregistrer.