Autorisation et intégration API

Autoriser uniquement lorsque toutes les conditions sont remplies

Vérifiez l'acteur et le organisation authentifiés, l'action demandée, l'enregistrement et la validité de l'accord. Refuser par défaut lorsque les conditions requises sont manquantes.

Acteur

Le service ou partenaire authentifié. Ne faites pas confiance à client_id dans le corps de la demande.

Enregistrement

Limitez les enregistrements au tenant_id authentifié.

Action et objectif

Vérifiez les autorisations telles que shipping.address.read et leur objectif de livraison associé.

Conditions supplémentaires

Vérifiez l'audience, l'expiration, la révocation, le nombre d'utilisations et la relation avec la personne.

Des décisions cohérentes

Tenez compte des changements d’état entre les mises à jour d’autorisation, de récupération et de nombre d’utilisations.

Authentification et informations d'identification du service

Utilisez les jetons Bearer applicatifs Microsoft Entra : Managed Identity sur Azure ou clé privée de certificat pour obtenir le jeton. Il ne s’agit pas de mTLS. Le Vault actuel fait confiance à un seul annuaire Entra ; une autre organisation n’est pas admise automatiquement. Gardez les identifiants côté serveur.

Restrictions d'audience

Validez l’audience et la destination du jeton. Rejetez les jetons émis pour une autre API.

Rotation des identifiants d’authentification

Gérez le retrait des anciennes informations d’identification et la fenêtre de transition.

Informations d'identification séparées du navigateur et du serveur

N'intégrez jamais les informations d'identification du serveur dans JavaScript ou HTML.

Erreurs, tentatives et audit

Enregistrez les raisons du refus en interne sans révéler les dossiers ou les données personnelles des autres organisations. Lorsqu'un délai d'attente laisse le résultat incertain, utilisez des clés d'idempotence ou des requêtes d'état plutôt que de réessayer aveuglément.

401 / 403

Distinguer l'authentification manquante de l'autorisation manquante. Enregistrez les détails dans des journaux internes protégés.

404

Envisagez des réponses indiscernables pour les enregistrements manquants et non autorisés.

409 / 429

Conflits d’idempotence et limites de taux. Définissez la politique de nouvelle tentative et les périodes d’attente.

503

Si l’état d’autorisation ou de révocation ne peut pas être vérifié, arrêtez plutôt que de traiter la demande comme autorisée.

DATA / INTEGRATION EXAMPLE

Exemple de données et d'intégration

Ces échantillons expliquent la conception. Les noms et valeurs des champs sont donnés à titre indicatif et ne constituent pas une référence API exécutable.

{
  "operation": "Authorization inputs and decision example",
  "authenticated_context": {
    "tenant_id": "tenant_a",
    "client_id": "carrier-a"
  },
  "request": {
    "action": "shipping.address.read",
    "resource_ref": "order_example_01",
    "purpose": "fulfillment"
  },
  "decision": {
    "allowed": true,
    "fields": [
      "postal_code",
      "address",
      "recipient_name"
    ],
    "decision_id": "dec_example_01"
  }
}

Créez un contexte d’authentification à partir d’informations d’identification vérifiées. N’utilisez jamais un tenant_id fourni par le client comme autorité.

Conceptions techniques associées

Intégration conçue pour vos workflows.

Cartographiez les données conservées, les partenaires et les actions requises pour identifier les moyens de réduire l’exposition.