Skip to main content

​
Présentation

Les secrets d’une source (mots de passe, clés privées, clés d’accès, en-têtes d’authentification) peuvent être remplacés en une seule requête, sans reconfigurer la source ni publier de nouvelle version. Utilisez-la lorsqu’un identifiant expire, fuite ou est renouvelé par votre fournisseur. La requête ne modifie que les secrets envoyés. Le reste de la configuration de la source est conservé, et les secrets ne sont jamais renvoyés dans les réponses API.

​
Secrets par type de source

Seuls les champs ci-dessous sont acceptés. Les champs imbriqués utilisent un chemin séparé par des points.
Les noms d’en-têtes URL sont comparés sans tenir compte de la casse : options.headers.authorization remplace un en-tête Authorization existant au lieu d’en ajouter un second. Les en-têtes absents de la liste ci-dessus ne peuvent pas être modifiés avec cette requête.

​
Effectuer la rotation

Avant de commencer, définissez ces valeurs : L’objet secrets associe chaque champ secret à sa nouvelle valeur. Cet exemple renouvelle les identifiants d’une source SFTP :
  • Un champ avec une valeur remplace le secret enregistré. Un champ à null le supprime. Un champ omis conserve sa valeur actuelle.
  • Les valeurs sur plusieurs lignes (clés privées au format PEM ou armored) doivent conserver leurs retours à la ligne, écrits \n dans la chaîne.
  • Renouvelez les secrets associés dans la même requête, par exemple accessKey et secretKey sur S3, ou pgpPrivateKey et pgpPassphrase.
  • Les nouveaux secrets s’appliquent à la version live de la Datasource, à son brouillon et à toute version en attente de vérification. Les anciens secrets ne peuvent pas revenir lors d’une publication ultérieure.
Un statut 204 confirme la modification. Un champ qui n’est pas un secret de la source, un objet secrets vide ou un SOURCE_INDEX inexistant renvoie 400, et rien n’est enregistré.
Lorsque le résultat contient une pgpPrivateKey, Reelevant vérifie que la clé peut être lue et déverrouillée avec la phrase de passe avant d’enregistrer quoi que ce soit. Une clé invalide ou une mauvaise phrase de passe renvoie 400. Consultez Déchiffrement PGP. Les autres secrets sont enregistrés tels quels et vérifiés par le prochain import.

​
Après la rotation

La requête ne lance pas d’import. Une Datasource planifiée utilise les nouveaux secrets dès son prochain import. Pour les vérifier immédiatement, déclenchez une nouvelle exécution de la Datasource et consultez ses logs. Pour une Datasource Kafka continue (mode ingester), il n’y a pas de prochain import : consultez ses logs après la rotation.