Équipes et contrôle d'accès

Gérez qui accède à votre organisation, et ce que chacun peut y faire.

Les organisations

Une organisation est un espace de travail qui regroupe vos projets, vos applications et les membres de votre équipe. Chacune a :

• ses projets et ses applications ;
• ses bases de données et ses ressources ;
• son abonnement de facturation (l'offre de l'instance) ;
• ses membres et leurs rôles ;
• ses canaux de notification.

Les membres de l'équipe

Inviter quelqu'un

1. Allez dans Organization Settings → Team
2. Cliquez sur Invite Member
3. Saisissez son adresse e-mail
4. Choisissez un rôle
5. Cliquez sur Send Invite

La personne invitée reçoit un e-mail contenant un lien pour rejoindre votre organisation. L'invitation reste en attente jusqu'à ce qu'elle l'accepte, et expire au bout de 48 heures.

Les invitations en attente figurent sous Invitations. Depuis le menu d'actions d'une ligne, vous pouvez :

• Copy Invitation — copier le lien pour le transmettre vous-même, par exemple si l'e-mail est tombé dans les indésirables ;
• Resend Email — renvoyer la même invitation. Le lien et la date d'expiration ne changent pas ;
• Cancel Invitation — la révoquer, ce qui rend le lien inopérant.

Accepter une invitation

Le lien ouvre une page qui n'accepte l'invitation que pour l'adresse à laquelle elle a été envoyée :

• Vous avez déjà un compte avec cette adresse ? Connectez-vous : vous revenez sur l'invitation pour l'accepter.
• Pas encore de compte ? Créez-le depuis cette page. L'adresse y est préremplie et verrouillée. Validez-la depuis l'e-mail que nous vous envoyons : le lien de vérification vous ramène à l'acceptation.
• Connecté avec une autre adresse ? Déconnectez-vous d'abord, puis rouvrez le lien.

Un lien indiquant que l'invitation n'est pas valide a expiré, a été annulé ou a déjà servi. Demandez-en un nouveau.

Les rôles

Rôle	Droits
Owner	Accès complet. Gère la facturation, l'équipe et toutes les ressources. Ne peut pas être retiré.
Admin	Gère les projets, les applications, les bases de données et les membres. Ne gère pas la facturation.
Member	Consulte et déploie les applications. Ne peut ni créer ou supprimer des projets, ni gérer l'équipe.

Gérer les membres

• Changer un rôle : Settings → Users → cliquez sur le membre → choisissez le nouveau rôle
• Retirer un membre : Settings → Users → cliquez sur Remove en face du membre
• Limiter un membre à certains projets : Settings → Users → Add Permissions sur le membre → cochez les projets sous Projects

Authentification

Adresse e-mail et mot de passe

Inscription classique, avec vérification de l'adresse. Le mot de passe doit :

• faire au moins 8 caractères ;
• de préférence mêler lettres et chiffres.

Fournisseurs OAuth

Connexion par un fournisseur tiers, selon ce que la plateforme propose :

• GitHub
• Google
• GitLab

Double authentification (2FA)

Ajoutez une couche de sécurité avec une double authentification de type TOTP :

1. Allez dans Account Settings → Security
2. Cliquez sur Enable 2FA
3. Scannez le QR code avec votre application d'authentification (Google Authenticator, Authy, 1Password…)
4. Saisissez le code de vérification
5. Mettez vos codes de récupération en lieu sûr

attention

Conservez vos codes de récupération précieusement. Si vous perdez l'accès à votre application d'authentification sans avoir ces codes, il vous faudra contacter votre administrateur de plateforme.

Clés d'API

Les clés d'API donnent un accès programmatique aux ressources de votre organisation.

Créer une clé

1. Allez dans Account → API Keys
2. Donnez-lui un nom (par exemple « Chaîne CI/CD »)
3. Cliquez sur Create
4. Copiez la clé immédiatement : elle n'est affichée qu'une fois et ne peut plus être récupérée ensuite

Une clé vaut pour l'organisation active

Il n'y a pas de sélecteur de droits. Une clé est liée, à sa création, à l'organisation active dans le sélecteur, et elle porte les droits de l'utilisateur qui l'a créée. Pour agir sur une autre organisation, changez d'abord d'organisation, puis créez une seconde clé.

Comme la clé hérite de vos propres droits, modifier ou retirer le rôle de cet utilisateur modifie du même coup ce que la clé peut faire.

Utiliser une clé

Transmettez-la dans l'un ou l'autre en-tête, les deux sont acceptés :

curl -H "Authorization: Bearer votre-cle-api" \
  https://votre-instance-kuploy.com/api/...

curl -H "x-api-key: votre-cle-api" \
  https://votre-instance-kuploy.com/api/...

Gérer les clés

• Supprimer : allez dans Account → API Keys et cliquez sur Delete en face de la clé. La suppression est immédiate et irréversible — tout appelant utilisant encore cette clé reçoit aussitôt des 401, alors déployez d'abord la clé de remplacement.
• Renouvelez périodiquement : créez la nouvelle clé, mettez à jour vos appelants, puis supprimez l'ancienne.
• Supprimez les clés inutilisées plutôt que de les laisser actives.

Bonnes pratiques

1. Accordez le minimum nécessaire — donnez à chacun le rôle le plus restreint qui suffise
2. Activez la double authentification — en particulier sur les comptes administrateur et propriétaire
3. Renouvelez vos clés d'API — notamment celles utilisées dans les chaînes CI/CD
4. Revoyez les accès régulièrement — vérifiez qui a accès et retirez les membres inactifs
5. Une clé par service — ne partagez pas une même clé entre plusieurs systèmes