La connexion d'une application se fait en sept étapes courtes. Ouvrir Paramètres, puis Sécurité, choisir Identité & connexion, puis Les applications connectées, puis appuyez sur Connecter une application. Vous avez besoin du Gérer les applications connectées permission.
Rien n'est sauvegardé jusqu'à ce que Connectez l'application Personne n'est affecté jusqu'à ce que quelqu'un se connecte à l'application.
Connecter une application
À droite des étapes 2, 4 et 6, vous voyez une image de la page que les utilisateurs verront la première fois qu'ils se connecteront, tirée de vos choix.
Étape 1: Choisissez ce que vous connectez
Choisissez le produit: WordPress, Grafana, Discours, Moodle, Nextcloud, Mattermost, Zapier ou Marque. Kamo connaît alors son adresse de retour, les permissions dont il a généralement besoin et les étapes exactes pour y arriver.
Pas dans la liste ? Choisir Site Web personnalisé pour un site web avec son propre serveur, Une seule page App pour une application web qui s'exécute dans le navigateur (React, Vue, etc.) ou L'application mobile Pour une application iPhone, Android ou de bureau. Service de back-end, pour un programme qui se connecte en tant que lui-même, sera disponible plus tard.
Étape 2: Nom et logo
Le nom et le logo que les utilisateurs voient sur les pages de connexion et d'autorisation, afin qu'ils sachent quelle application demande l'accès. Le logo est facultatif : indiquez l'adresse https:// d'une image carrée ou laissez-le vide pour utiliser la marque propre du produit.Une description d'une ligne s'affiche la première fois que les utilisateurs se connectent.
Étape 3: Adresses de retour
Une fois que quelqu'un s'est connecté, Kamo le renvoie à l'application, mais uniquement à une adresse répertoriée ici, comparée lettre par lettre, ce qui empêche toute personne de prétendre être votre application et d'attraper une connexion en cours de route.
Les adresses doivent commencer par https://. Les applications mobiles et de bureau peuvent également utiliser leur propre adresse, telle que com.yourcompany.app:/callback, ou http://127.0.0.1 sur n'importe quel port.
Adresse de votre site
Pour WordPress, Grafana, Discourse, Moodle, Nextcloud et Mattermost, saisissez l'adresse utilisée pour accéder au produit, par exemple https://blog.yourcompany.com. Kamo Pour Make, il n'y a rien à taper. Pour Make, il n'y a rien à taper Zapier, un site Web personnalisé, une application à page unique ou une application mobile, collez l'adresse de retour que vous donne l'application ou votre développeur.
Vous pouvez ajouter d'autres adresses, par exemple pour une copie de test du site.
Adresses de sortie
En dessous Plus de paramètres de déconnexion: où les utilisateurs peuvent être envoyés après s'être déconnectés via l'application. Laissez-le vide si l'application ne déconnecte pas les utilisateurs de Kamo.Pour Grafana, Kamo le remplit pour vous.
Notifications de déconnexion
Également sous Plus de paramètres de déconnexion, pour les sites Web : lorsque quelqu'un se déconnecte de Kamo, Kamo peut indiquer à l'application à cette adresse qu'elle doit également le déconnecter back-channel logout; la plupart ne le font pas, et il est bon de le laisser vide.
Comment l'application envoie son secret
Pour les sites Web : comment l’application prouve son identité lorsqu’elle recueille les données de connexion De base, sauf si les instructions de l'application disent "client secret post".
Étape 4: Ce que l'application peut voir
Chaque commutateur est une chose que l'application peut apprendre sur la personne qui se connecte:
- Sign-In: que ce soit la même personne à chaque fois. Toujours allumé.
- Nom et profil: leur nom, nom d'utilisateur, fuseau horaire et langue.
- E-mailLa plupart des applications en ont besoin pour reconnaître les personnes qui ont déjà un compte sur leur site.
- Téléphone: le numéro de téléphone sur leur profil.
- Organisation des Nations Unies: à quelle organisation ils appartiennent, et s’ils font partie de son équipe ou sont un client.
- Rôles et équipes: leurs rôles, départements, fonctions et équipes, afin que l'application puisse leur donner le bon accès.
- Restez connecté: l'application peut continuer à fonctionner pour eux quand ils sont absents, jusqu'à ce que l'accès soit retiré. Zapier, Make et les applications mobiles en ont besoin.
Donnez à l’application uniquement ce dont elle a besoin : les utilisateurs voient cette liste la première fois qu’ils se connectent.
Étape 5: Qui peut l'utiliser
Pour votre équipe, choisissez Tout le monde, Certaines personnes ou Personne. With Certaines personnes, choisissez les départements, les titres de poste et les équipes, et ajoutez des personnes par nom; quelqu'un peut utiliser l'application s'ils correspondent à l'un d'eux.
Clients
Les clients sont les personnes que votre organisation sert et qui ne font pas partie de votre équipe, comme les emprunteurs ou les patients Pas de clients. Choisir une option Pour tous les clients ou Quelques clients pour une application destinée à eux, comme un portail client.
Étape 6: Demander d'abord ou pré-approuver
Demandez d'abord à chaque personne Montre aux gens ce que l'application va apprendre et leur permet de dire non, la première fois. Pré-approuver pour tout le monde Pré-approuvez vos propres outils d’entreprise ; demandez d’abord à vos clients ce qu’ils utilisent, puis demandez-leur ce qu’ils utilisent.
Un numéro de membre privé
Normalement, chaque application voit le même numéro pour une personne Donnez à cette application un numéro de membre privé Et cette application obtient son propre numéro pour chaque personne à la place, donc deux applications ne peuvent pas correspondre à la même personne.La plupart des applications n'en ont pas besoin.
Presse Connectez l'application (ou Enregistrer les modifications lorsque vous êtes en train d'éditer).
Étape 7: Terminer dans l'application
L'application est connectée. Le dernier écran montre:
- The Numéro de client, qui nomme votre application Kamo. Ce n'est pas secret.
- The Le secret du client Pour un site web (voir ci-dessous).
- Les étapes exactes à terminer dans le produit, avec chaque valeur remplie et un bouton de copie à côté de chacune.
- Exemples de code Créez votre propre site Web ou application en Node, Python et PHP (et le navigateur, pour une application d'une seule page).
Le secret du client
Le secret est le mot de passe de l'application, et il est montré Seulement maintenant. Copiez-le dans l'application ou téléchargez le fichier .env avant de fermer la fenêtre, puis cochez J’ai gardé le secret. Si elle est perdue, utilisez Faire pivoter Secret Les applications à page unique et les applications mobiles n'ont pas de secret pour vous.
Le fichier .env
Télécharger le fichier .env Enregistre un petit fichier texte avec toutes les valeurs dont l'application a besoin (l'adresse de connexion, l'adresse de découverte, l'identifiant du client, le secret, l'adresse de retour et les permissions) dans le format que la plupart des frameworks lisent.
Exemples de code
Code de connexion fonctionnel pour un site Web ou une application de votre choix. Chaque exemple lit le fichier .env, de sorte que le même fichier fonctionne avec tous les fichiers. Ils utilisent des bibliothèques open source bien connues: openid-client pour Node, Authlib pour Python et OpenID Connect PHP pour PHP.
Les articles connexes
Autres guides qui répondent à des questions proches de celle-ci.
Créez une application sur la connexion de votre organisation
Cette page est destinée aux développeurs. La connexion de votre organisation est une connexion standard OAuth 2.0 et OpenID Connect Le fournisseur d'applications peut être un fournisseur de services, de sorte que…
Les applications connectées
Les applications connectées permettent à vos utilisateurs de se connecter à d'autres sites Web et applications, tels que WordPress, Grafana, Moodle, Nextcloud ou votre propre site Web, avec le compte Kamo dont ils…
Identité et connexion
Votre organisation dispose de sa propre page de connexion, à Connectez-vous. Cette page décide de ce que cette page de connexion offre : quels sont les moyens d'accès, quels comptes les utilisateurs peuvent apporter…
Utilisez votre organisation comme fournisseur d'identité SAML
Certaines des applications utilisées par votre équipe (wikis, bureaux d'assistance, plateformes d'apprentissage, tableaux de bord) permettent aux utilisateurs de se connecter Authentification unique SAML Kamo peut être…
Laissez les applications se connecter d'elles-mêmes
Certaines applications, telles que les assistants AI qui utilisent MCP et les outils de ligne de commande, peuvent se connecter elles-mêmes à la connexion de votre organisation au lieu d'être saisies par un…
Applications avec accès
Votre organisation peut vous autoriser à vous connecter à d'autres sites Web et applications avec votre compte d'organisation, tels qu'un blog d'entreprise, des tableaux de bord ou un site de formation.La première fois…
Se connecter sur un téléviseur ou un appareil
Certaines applications s'exécutent sur des écrans où la saisie d'un mot de passe est gênante, comme un téléviseur dans le hall d'accueil, un écran dans une salle de réunion, une imprimante, une console de jeu ou un…
