Comment fonctionne l'authentification pour les API externes et les webhooks ?
L'authentification aide à garantir que la communication entre les systèmes logiciels est autorisée.
Les API externes et les webhooks peuvent utiliser différents mécanismes d'authentification en fonction du fournisseur, de l'implémentation de l'intégration et des exigences de sécurité de l'opération.
Comprendre ces mécanismes est important lors de la connexion des systèmes d'entreprise à Polyosync.
Méthodes courantes d'authentification API
Clés API
Une clé API est un identifiant émis par un fournisseur de services pour identifier ou autoriser l'accès à l'API.
OAuth
OAuth est un cadre d'autorisation qui permet aux applications de recevoir un accès limité aux ressources prises en charge sans exiger que les utilisateurs partagent directement leurs mots de passe avec l'application demandeuse.
Tokens Bearer
Un token bearer est un identifiant couramment inclus dans un en-tête d'autorisation HTTP.
Authentification de base
Certains services prennent en charge l'authentification à l'aide d'un nom d'utilisateur et d'un mot de passe ou d'une autre paire de crédentiels.
Authentification personnalisée
Certains systèmes d'entreprise utilisent des mécanismes d'authentification propriétaires ou des contrôles de sécurité supplémentaires.
La disponibilité de chaque méthode dans Polyosync dépend de la fonctionnalité d'intégration prise en charge.
Comment l'authentification des webhooks est-elle différente ?
L'authentification des webhooks se concentre sur la vérification qu'un événement entrant a été envoyé par une source autorisée.
Les mécanismes de vérification courants incluent :
1. Signatures cryptographiques.
2. Secrets partagés.
3. En-têtes d'autorisation.
4. Procédures de vérification spécifiques au fournisseur.
Le mécanisme approprié dépend de l'expéditeur et du destinataire.
Qu'est-ce qu'une signature de webhook ?
Certains fournisseurs génèrent une signature cryptographique en utilisant un secret partagé et des informations de la demande.
Le système récepteur peut vérifier la signature pour aider à déterminer si la demande est authentique et n'a pas été modifiée.
Puis-je utiliser les mêmes identifiants pour plusieurs intégrations ?
Cela dépend du fournisseur et de la politique de sécurité de votre organisation.
Des identifiants séparés sont souvent préférables car ils permettent de restreindre et de révoquer l'accès de manière indépendante.
Quelles autorisations devrais-je accorder ?
Accordez uniquement les autorisations nécessaires pour l'opération prévue.
Par exemple, un processus qui a seulement besoin de récupérer des informations ne devrait pas recevoir d'autorisations d'écriture à moins qu'elles ne soient nécessaires.
Que se passe-t-il lorsque un token API expire ?
Les demandes utilisant un token expiré peuvent échouer jusqu'à ce qu'une autorisation valide soit rétablie.
Certains fournisseurs prennent en charge des mécanismes de renouvellement de token, tandis que d'autres nécessitent une réautorisation manuelle.
Le comportement dépend du fournisseur et de l'implémentation de l'intégration.
Comment les identifiants doivent-ils être gérés ?
1. Ne publiez jamais de clés API ou de tokens d'accès.
2. Évitez de placer des identifiants dans des URL publiques.
3. N'incluez pas de secrets dans les captures d'écran de support.
4. Faites tourner les identifiants lorsque cela est nécessaire.
5. Révoquez les identifiants qui ne sont plus nécessaires.
6. Utilisez des identifiants de test et de production séparés lorsque cela est pris en charge.
7. Révisez les autorisations périodiquement.
8. Restreignez qui peut gérer les identifiants d'intégration.
Que faire si les identifiants sont compromis ?
Révoquez ou faites tourner les identifiants affectés via le fournisseur externe.
Examinez l'activité d'accès pertinente et enquêtez pour savoir si des opérations non autorisées ont eu lieu.
Mettez à jour la configuration d'intégration affectée avant de reprendre le fonctionnement normal.
L'authentification garantit-elle qu'une opération est sûre ?
Non.
L'authentification établit l'identité ou l'autorisation, mais une validation supplémentaire et des contrôles commerciaux peuvent encore être nécessaires.
Approche recommandée
Utilisez le mécanisme d'authentification le plus fort pris en charge par l'intégration et le fournisseur externe.
Appliquez des autorisations de moindre privilège et maintenez un processus clair pour le renouvellement et la révocation des identifiants.