Application Qovery

Qovery est une plateforme de gestion et de déploiement d'infrastructures Kubernetes. MIA s'y connecte pour inventorier les utilisateurs, envoyer des invitations et gérer la suppression de leurs accès.

Type d'authentification et pré-requis

Type d'authentification — Clé API

Pré-requis

Disposer d'un jeton d'API Qovery autorisé à lister les organisations et les rôles, ainsi qu'à lire, inviter et supprimer leurs utilisateurs.

Configuration du jeton

Pour un jeton utilisant une politique fine-grained avec default allow := false, remplacez <ORGANIZATION_ID> par l'UUID de l'organisation et ajoutez les règles suivantes :

allowed_organization_id := "<ORGANIZATION_ID>"

allow if list_organizations
allow if read_organization_members
allow if delete_organization_member
allow if list_organization_roles
allow if manage_organization_invitations
allow if delete_organization_invitation

list_organizations if {
  input.request.method in {"GET", "HEAD"}
  input.request.path == ["api", "organization"]
}

read_organization_members if {
  input.request.method in {"GET", "HEAD"}
  input.request.path == [
    "api",
    "organization",
    allowed_organization_id,
    "member",
  ]
}

delete_organization_member if {
  input.request.method == "DELETE"
  input.request.path == [
    "api",
    "organization",
    allowed_organization_id,
    "member",
  ]
}

list_organization_roles if {
  input.request.method in {"GET", "HEAD"}
  input.request.path == [
    "api",
    "organization",
    allowed_organization_id,
    "availableRole",
  ]
}

manage_organization_invitations if {
  input.request.method in {"GET", "POST"}
  input.request.path == [
    "api",
    "organization",
    allowed_organization_id,
    "inviteMember",
  ]
}

delete_organization_invitation if {
  input.request.method == "DELETE"
  [
    "api",
    "organization",
    allowed_organization_id,
    "inviteMember",
    _,
  ] = input.request.path
}

Ces règles autorisent uniquement la liste des organisations et des rôles, la lecture des membres et invitations, l'envoi d'une invitation, ainsi que la suppression d'un membre ou d'une invitation.

L'ajout d'un utilisateur depuis MIA envoie une invitation avec le rôle sélectionné. Pour des raisons de sécurité, l'utilisateur invité doit accepter lui-même cette invitation avec son compte Qovery ; le jeton d'organisation MIA ne peut pas l'accepter à sa place.

Étapes de connexion

1. Dans la console Qovery, ouvrez les paramètres de votre organisation puis API Token.
2. Créez un jeton avec les droits nécessaires, configurez sa politique comme ci-dessus et copiez-le.
3. Dans MIA, ouvrez Applications → Ajouter une application, recherchez Qovery, renseignez le jeton, puis cliquez sur Connecter.
4. Sélectionnez l'organisation à synchroniser dans la liste proposée.

::: Source officielle Qovery documente l'authentification à son API, la liste des rôles, l'invitation d'un utilisateur et la suppression d'un utilisateur. :::