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
- L’utilisateur saisit le mode hôte/port/sécurité IMAP et SMTP et les valeurs secrètes.
- L’interface utilisateur crée des informations d’identification avec
POST /api/accounts/:account_id/provider-credentials. - L’interface utilisateur valide immédiatement en utilisant
POST /api/provider-credentials/:provider_credential_id/test. - L’interface utilisateur répertorie les informations d’identification et l’état de validation.
- 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