Aller au contenu principal

Connecter Acronis Cyber Protect Cloud

Ce guide explique comment créer le client API Acronis demandé par le formulaire de connexion d'Alerion (Paramètres → Connecteurs → Acronis Cyber Protect). Alerion lit l'état des sauvegardes en lecture seule.

Prérequis​

  • Un accès administrateur au portail de gestion Acronis Cyber Protect Cloud du client final. La page officielle ne précise pas le rôle exact nécessaire pour créer un client API : si l'entrée Paramètres → Clients API n'apparaît pas, demandez-le à l'administrateur Acronis du client.
  • Une offre Alerion qui comprend le connecteur (Business ou supérieure).

Règle Alerion : client final, jamais niveau partenaire​

Créez le client API dans le tenant du client final, jamais au niveau partenaire. Cette règle est celle d'Alerion, pas d'Acronis : un client API créé au niveau partenaire verrait aussi les autres clients du partenaire, et Alerion le refuse à la connexion (message « Cette clé a été créée au niveau partenaire »). Alerion accepte les clients de type customer ou unit.

La page officielle d'Acronis ne dit pas à quel tenant est rattaché le client créé ; la documentation développeur indique seulement que le jeton permet d'opérer dans le tenant du client API « et ses sous-tenants ». Vérifiez donc, avant de créer le client, que vous êtes bien positionné dans le tenant du client final.

Créer le client API pas à pas​

Étapes tirées de la page officielle « Creating an API client » (voir Sources) :

  1. Dans le portail de gestion Acronis, ouvrez Paramètres → Clients API, puis cliquez sur Créer un client API (Settings → API clients → Create API client).
  2. Saisissez un nom, par exemple Alerion (lecture).
  3. Cliquez sur Suivant. Le client est créé avec le statut Actif.
  4. Copiez et conservez immédiatement l'ID, la valeur du secret et l'URL du centre de données. Le secret n'est affiché qu'une seule fois ; s'il est perdu, il ne peut pas être récupéré, mais il peut être réinitialisé pour en générer un nouveau.
  5. Cliquez sur Terminé.

Les intitulés exacts des menus peuvent varier selon la version du portail (la page officielle consultée est celle de la version 25.09).

Valeur de chaque champ du formulaire Alerion​

Champ AlerionValeur à saisir
URL du centre de donnéesL'URL affichée avec le client API, par exemple https://eu2-cloud.acronis.com (exemple de la documentation développeur d'Acronis).
Identifiant du client APIL'ID du client, affiché à la création.
Secret du client APILa valeur du secret, affichée une seule fois.

Le secret est chiffré par Alerion, n'est jamais affiché de nouveau et n'est jamais écrit dans les journaux.

Vérification​

À la validation du formulaire, Alerion vérifie, avant de stocker quoi que ce soit : que le jeton est accepté, le tenant et le type du client API (client final uniquement), puis qu'il peut lire les statuts de protection. Si l'une de ces étapes échoue, rien n'est enregistré. Une fois connecté, la fiche de la connexion indique la date de la dernière synchronisation.

Erreurs courantes​

  • « Acronis a refusé l'identifiant ou le secret » : vérifiez d'abord que l'URL du centre de données est bien celle affichée avec le client API (un mauvais centre de données provoque un refus HTTP 401), puis le secret. Si le secret est perdu, réinitialisez-le dans le portail Acronis.
  • « Cette clé a été créée au niveau partenaire » : recréez le client API dans le tenant du client final.
  • « Alerion n'a pas pu vérifier ces identifiants » : le fournisseur n'a pas répondu ; réessayez dans quelques instants. Rien n'a été enregistré.

Sources​