Une connexion vous permet de stocker en toute sécurité vos identifiants d’API pour un service ou un système, comme Slack ou Shopify. Vous pouvez utiliser une connexion pour authentifier les appels API REST à l’étapeEffectuer un appel APIdu Créateur de workflow. Vous devez être administrateur pour créer des connexions.
À propos des connexions
Une connexion prend en charge l’une des méthodes d’authentification d’API suivantes :
- Clé API
- Authentification de base
- Token du porteur
Cette méthode d’authentification détermine le type d’identifiants que stocke la connexion. Par exemple, une connexion d’authentification de base stocke un nom d’utilisateur et un mot de passe. Une fois une connexion créée, vous ne pouvez pas changer son type d’authentification.
Les différentes API prennent en charge différentes méthodes d’authentification. Pour déterminer la méthode d’authentification appropriée pour un appel API, consultez la documentation de l’API.
d 'authentification En-tetes HTTP倒les类型
| Type d’authentification | En-tête HTTP |
|---|---|
| Clé API | Définie quand vous créez la connexion. ConsultezEn-têtes HTTP pour les clés API． |
| Authentification de base | Authorization: Basic |
| Token du porteur | Authorization: Bearer |
Pour en savoir plus sur l’utilisation d’une connexion dans le Créateur de workflow, consultezUtilisation de l’étape Effectuer un appel API dans le Créateur de workflow．
Création d’une connexion
Vous pouvez créer une connexion dans le Centre d’administration, à la page Connexions.
Pour créer une connexion
- Dans leCentre d’administration, cliquez sur l’icôneApplications et intégrations
dans la barre latérale, puis sélectionnezConnexions > Connexions． - Cliquez surCréer une connexion．
- Sélectionnez un type d’authentification.
- Saisissez un nom pour la connexion. Une fois la connexion créée, vous ne pouvez plus changer ce nom.
- Configurez les identifiants d’authentification de la connexion. La connexion utilise ces détails pour authentifier les appels API REST au service ou au système.
- Saisissez un domaine autorisé pour la connexion. Une fois la connexion créée, vous ne pouvez plus changer le domaine autorisé. Pour en savoir plus, consultezDomaine autorisé．
- Cliquez surEnregistrerpour créer la connexion.
Une fois la connexion créée, vous pouvez en voir les détails à la page Connexions du Centre d’administration. ConsultezGestion des connexions．
Domaine autorisé
Chaque connexion nécessite un nom d’hôte d’URL comme domaine autorisé. Zendesk ne transfère les identifiants de la connexion que dans les appels API à ce nom d’hôte. Toute tentative d’utilisation de la connexion avec d’autres noms d’hôte échouera. Cela aide à éviter une fuite accidentelle des identifiants de la connexion. Une fois une connexion créée, vous ne pouvez pas changer son domaine autorisé.
Par exemple, vous pouvez uniquement utiliser une connexion avec le domaine autorisé « api.example.com » pour effectuer des appels API au nom d’hôte « https://api.example.com ».
Spécifications pour le domaine autorisé
Le domaine autorisé d’une connexion ne doit pas dépasser 128 caractères. Un sous-domaine ou un domaine au sein de la valeur ne peut pas dépasser 63 caractères. La valeur doit contenir un nom de domaine valide.
Une connexion utiliser toujours un schémahttps．Les autres schémas, commeftps, ne sont pas pris en charge.
Caractères génériques pour le domaine autorisé
Le domaine autorisé d’une connexion prend en charge un sous-domaine générique (*) facultatif. Cela vous permet d’utiliser la connexion avec le domaine brut et n’importe quel sous-domaine. Par exemple, vous pouvez utiliser une connexion avec le domaine autorisé*.example.compour authentifier les appels API à « example.com » ou n’importe quel sous-domaine de « example.com ».
Pour utiliser un sous-domaine générique, les deux premiers caractères du domaine autorisé doivent être*.．你们不普vez pas utiliser de caractère générique dans les autres parties du nom d’hôte. Par exemple, vous ne pouvez pas utiliser de caractère générique au sein d’un nom d’hôte, commeexam*.comoumy-*.example.com.
你们不普vez pas utiliser de caractère générique uniquement avec unsuffixe de domaine public, comme*.com,*.com.auou*.myshopify.com．Pour consulter laliste des suffixes publics, rendez-vous sur publicsuffix.org.
En-têtes HTTP pour les clés API
Quand vous créez une connexion de clé API, vous devez spécifier un nom d’en-tête HTTP. Quand la connexion est utilisée pour effectuer un appel API, Zendesk transfère la clé API comme valeur pour cet en-tête.
De nombreuses API utilisent un en-tête personnalisé pour accepter les clés API. Pour obtenir le nom d’en-tête approprié pour un appel API, consultez la documentation de l’API.
Spécifications pour les noms d’en-tête
Le nom d’en-tête d’une connexion de clé API ne peut pas dépasser 128 caractères. Le nom d’en-tête peut uniquement contenir des lettres, des tirets (-) et des traits de soulignement (_).
acceptaccept-charsetaccept-encodingaccept-languagecache-controlconnectioncontent-md5cookiedateexpectfromhostif-matchif-modified-sinceif-none-matchif-rangeif-unmodified-sincemax-forwardspragmaproxy-authenticateproxy-authorizationrangeserverreferertetrailer传输编码upgradeuser-agentviawarningwww-authenticate- Noms d’en-tête commençant par :
x-amz-
x-amzn-x-forwarded-x-zis-
0 Commentaires
Vous devezvous connecterpour laisser un commentaire.