Organisations

Une organisation regroupe des identifiants sous un seul propriétaire afin que plusieurs personnes puissent les partager : des clés API pour l'API JSON et des utilisateurs proxy pour le port proxy. Tout ce que consomment les identifiants d'une organisation est décompté du forfait du propriétaire de l'organisation, et non de la personne qui a émis la requête.

Où la trouver

Connectez-vous au tableau de bord et ouvrez Organisations dans la barre latérale. Chaque organisation à laquelle vous appartenez correspond à une ligne :

Colonne	Ce qu'elle affiche
Organisation	Le nom. Cliquez dessus, ou sur Ouvrir, pour accéder à la page de l'organisation.
Votre rôle	Propriétaire, Administrateur ou Membre
Membres	Combien de personnes en font partie, propriétaire inclus
Clés	Combien de clés API l'organisation possède
Créée le	Quand elle a été créée
Actions	Ouvrir

Créer une organisation

Cliquez sur Nouvelle organisation, saisissez un nom entre 2 et 60 caractères, puis confirmez. Vous en devenez le propriétaire. Le nom doit contenir au moins une lettre ou un chiffre, et ne peut pas correspondre au nom d'une organisation existante (la comparaison porte sur les lettres et les chiffres, tout le reste est ignoré).

La création d'une organisation nécessite un forfait couvrant plus d'une personne. La ligne Organisations que vous possédez sur la page Utilisation et limites indique si votre forfait le permet.

Rôles

Il en existe trois, et chaque organisation possède exactement un propriétaire.

Rôle	Ce qu'il permet de faire
Membre	Créer et utiliser les clés API et les utilisateurs proxy de l'organisation, renommer ses clés API, et voir les membres et les équipes de l'organisation
Administrateur	Tout ce qu'un membre peut faire, plus ajouter et supprimer des personnes, modifier leurs rôles, gérer tous les identifiants de l'organisation et renommer l'organisation
Propriétaire	Tout ce qu'un administrateur peut faire, plus transférer l'organisation à quelqu'un d'autre. Le propriétaire porte le forfait sur lequel tous les identifiants de l'organisation sont facturés.

Le propriétaire ne peut pas être supprimé, ne peut pas quitter l'organisation et ne peut pas être rétrogradé. La propriété ne se transmet que d'une seule façon : par transfert.

Faire partie de l'organisation donne accès à ses identifiants. Un membre sans droits d'administration peut tout de même créer une clé ou un utilisateur proxy payé par l'entreprise, ce qui est le but recherché : un développeur qui écrit des collecteurs ne devrait pas avoir besoin d'un identifiant personnel qui lui est discrètement facturé au lieu d'être facturé à l'entreprise.

La page de l'organisation

Cliquer sur Ouvrir sur n'importe quelle ligne vous amène à la page de cette organisation. Six cartes se trouvent en haut : Membres (avec la répartition propriétaire, administrateur et membre en dessous), Votre rôle, Propriétaire, Clés API, Utilisateurs proxy et Équipes. En dessous, deux onglets :

• Membres : les personnes de l'organisation, ainsi que les options de gestion accordées par votre rôle.
• Équipes : les équipes auxquelles vous appartenez au sein de cette organisation, en lecture seule.

Les propriétaires et les administrateurs disposent également d'un bouton Renommer dans l'en-tête de la page.

Ajouter des personnes

Les propriétaires et les administrateurs disposent d'une carte Ajouter un membre au-dessus du tableau des membres. Saisissez une adresse e-mail, choisissez Membre ou Administrateur, puis validez.

La suite dépend de l'adresse, et le tableau de bord vous indique laquelle a été traitée :

• L'adresse possède déjà un compte FourA : elle rejoint l'organisation immédiatement et reçoit un e-mail indiquant l'organisation, qui l'a ajoutée et les autorisations de son rôle.
• L'adresse n'en possède pas : FourA lui envoie une invitation et elle rejoint l'organisation dès sa connexion avec cette adresse. Rien à cliquer, et l'invitation fonctionne qu'il s'agisse d'une nouvelle inscription ou d'un compte déjà existant mais jamais utilisé.

Les invitations expirent après 14 jours. Ajouter à nouveau la même adresse réinitialise l'invitation en attente au lieu d'en superposer une deuxième.

Le propriétaire reçoit un e-mail dès qu'une personne rejoint l'organisation, car le nouveau membre consomme les crédits du propriétaire. Personne ne reçoit d'e-mail confirmant sa propre action.

Invitations en attente

Tant qu'au moins une invitation reste ouverte, un tableau Invitations apparaît au-dessus des Membres, visible par les propriétaires et les administrateurs. Il affiche l'adresse, le rôle qui l'attend, qui l'a invitée et à quelle date. Les invitations expirées restent affichées et sont signalées, ce qui vous permet de comprendre pourquoi personne n'a rejoint. Utilisez l'action située sur la ligne pour en retirer une.

Modifier un rôle

Les propriétaires et les administrateurs modifient le statut d'un membre entre Membre et Admin à l'aide du menu déroulant de la colonne Rôle. Trois règles :

• Vous ne pouvez pas modifier votre propre rôle. Demandez à un autre administrateur, ou quittez l'organisation.
• Le rôle du propriétaire n'est pas modifiable ici. Utilisez plutôt Make owner.
• Chaque modification demande une confirmation préalable et détaille ce que la personne pourra faire par la suite.

Supprimer un membre et quitter l'organisation

Les propriétaires et les administrateurs disposent du bouton Remove sur chaque ligne, sauf la leur et celle du propriétaire. Votre propre ligne affiche Leave, quel que soit votre rôle.

Supprimer un membre le retire également des équipes de l'organisation, ce qui lui fait perdre immédiatement l'accès à ses identifiants. Cela ne modifie pas les identifiants eux-mêmes : la clé ou l'utilisateur proxy d'une organisation appartient à l'organisation, pas à la personne qui l'a créée.

Le propriétaire ne peut ni être supprimé ni quitter l'organisation. Transférez d'abord l'organisation.

Transférer l'organisation

Seul le propriétaire peut effectuer cette action. Dans l'onglet Membres, cliquez sur Make owner sur la personne qui prend le relais et confirmez.

L'organisation bascule sur son forfait : dès cet instant, chaque request effectuée par ses clés et chaque tunnel ouvert par ses utilisateurs proxy sont décomptés de ses crédits, de son trafic, de ses limites et de sa facture. L'ancien propriétaire devient administrateur et conserve l'ensemble des autorisations associées à ce rôle.

Quelles clés vous pouvez voir

Toutes les clés appartenant à une organisation sont visibles par tous les membres de cette organisation. Les actions possibles varient selon votre rôle :

Action	Membre	Admin	Propriétaire
Utiliser la clé, l'afficher, créer des clés d'organisation	Oui	Oui	Oui
Renommer la clé, modifier sa description	Oui	Oui	Oui
Régénérer, désactiver, supprimer	Non	Oui	Oui
Déplacer la clé hors de l'organisation	Non	Non	Oui

Renommer une clé est sans impact. Régénérer ou désactiver une clé bloque instantanément chaque collègue qui l'utilise, c'est pourquoi ces actions sont réservées aux admins. Transférer une clé retire la ressource de l'entreprise et impute son utilisation sur le forfait du destinataire, c'est pourquoi cette action est réservée au seul propriétaire.

Consultez Managing API Keys pour le guide complet.

Which Proxy Users You See

Un proxy user suit les trois mêmes niveaux, pour les mêmes raisons.

Action	Member	Admin	Owner
Use it, read its password, create new ones	Yes	Yes	Yes
New password, disable, delete, change saved targeting	No	Yes	Yes
Transfer it out of the organization	No	No	Yes

Le ciblage enregistré est réservé aux admins plutôt qu'aux membres, car modifier sa cible redirige silencieusement chaque connexion établie par l'ensemble de l'organisation avec cet identifiant. La génération d'un nouveau mot de passe est également réservée aux admins, car elle invalide chaque fichier de configuration où l'identifiant est déjà renseigné.

Le téléchargeur d'une entreprise doit être associé au proxy user d'une organisation. Un proxy user personnel cesse de fonctionner dès le départ de cette personne, et lui est facturé. Consultez Proxy Users pour le guide.

The Owner Filter

Dès que vous appartenez à une organisation, un menu déroulant Owner apparaît au-dessus de Overview, Metrics, Activity, API Keys et Proxy. Il propose trois types d'options: Everything, Personal et une entrée par organisation. Le choix est conservé entre vos visites et s'applique à chacune de ces cinq pages.

Usage & Limits et Billing n'intègrent délibérément pas ce filtre. Ces pages répondent à la question « qu'est-ce qui m'est facturé », ce qui diffère de « qu'est-ce que je peux voir »: un membre ne voit jamais le quota du propriétaire.

Billing Attribution

Chaque request effectuée avec une clé appartenant à l'organisation, et chaque tunnel ouvert avec un proxy user appartenant à l'organisation, est facturé au propriétaire de l'organisation, quel que soit l'auteur de l'appel. C'est tout l'intérêt de transférer un identifiant vers une organisation: cela modifie l'entité à laquelle l'utilisation est imputée pour les crédits, le trafic, les limites de forfait et les factures.

La page Usage & Limits du propriétaire comptabilise les identifiants de l'organisation aux côtés de ses identifiants personnels, dans l'onglet API keys et l'onglet Proxy users, et sépare les deux pour identifier clairement l'origine des dépenses.

Teams

Chaque organisation dispose d'une équipe par défaut nommée Everyone. Les nouvelles clés y sont automatiquement associées et toute personne rejoignant l'organisation y est ajoutée, ce qui permet à chaque membre d'accéder aux clés.

L'onglet Teams liste les équipes auxquelles vous appartenez, avec votre rôle dans chacune, le nombre de membres et les clés qu'elle vous permet d'utiliser (Keys you can use). La création et la modification d'équipes ne sont pas encore disponibles dans le tableau de bord.

Related

• Gestion des clés API : Créez, transférez et gérez des clés au sein d'une organisation
• Utilisateurs proxy : Créez et transférez des utilisateurs proxy au sein d'une organisation
• Utilisation et limites : Membres de l'équipe, organisations et autorisations de votre forfait
• Facturation et abonnements : Comment le forfait du propriétaire couvre l'utilisation des clés de l'organisation
• Aperçu du tableau de bord : Toutes les sections du tableau de bord