IM
FR
Accueil documentation
Menu
Guides

Identifiants du fournisseur et connectivité

enregistrez les informations d'identification IMAP/SMTP, validez la connectivité et maintenez le cycle de vie des informations d'identification.

inbox-manager client-flow

Informations d’identification du fournisseur et connectivité

Objectif : enregistrer les informations d’identification IMAP/SMTP, valider la connectivité et maintenir le cycle de vie des informations d’identification.

Flux d’interface utilisateur

  1. L’utilisateur saisit le mode hôte/port/sécurité IMAP et SMTP et les valeurs secrètes.
  2. L’interface utilisateur crée des informations d’identification avec POST /api/accounts/:account_id/provider-credentials.
  3. L’interface utilisateur valide immédiatement en utilisant POST /api/provider-credentials/:provider_credential_id/test.
  4. L’interface utilisateur répertorie les informations d’identification et l’état de validation.
  5. L’interface utilisateur prend en charge la rotation (/rotate) et la suppression pour l’hygiène des informations d’identification.

Flux de bibliothèque client

const imapCredential = await api.credentials.create(accountId, {
  provider_kind: "imap",
  label: "Work IMAP",
  host: "mail.example.com",
  port: 993,
  security_mode: "ssl_tls",
  auth_kind: "password",
  secret: { username, password },
});
await api.credentials.test(imapCredential.data.id);

Flux HTTP/curl

API_BASE_URL="https://api.inbox-manager.com"

curl -sS -X POST "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/provider-credentials" \
  -H "authorization: Bearer ${BEARER_TOKEN}" \
  -H "content-type: application/json" \
  --data '{
    "provider_kind":"imap",
    "label":"Work IMAP",
    "host":"mail.example.com",
    "port":993,
    "security_mode":"ssl_tls",
    "auth_kind":"password",
    "secret":{"username":"user@example.com","password":"***"}
  }'

curl -sS -X POST "${API_BASE_URL}/api/provider-credentials/${PROVIDER_CREDENTIAL_ID}/test" \
  -H "authorization: Bearer ${BEARER_TOKEN}"

curl -sS -X POST "${API_BASE_URL}/api/provider-credentials/${PROVIDER_CREDENTIAL_ID}/rotate" \
  -H "authorization: Bearer ${BEARER_TOKEN}" \
  -H "content-type: application/json" \
  --data '{"secret":{"username":"user@example.com","password":"***"}}'

## Script de validation

  • scripts/provider_credentials_flow.sh