Premiers pas avec Skycloak

Bienvenue sur Skycloak ! Ce guide vous accompagne lors de votre première connexion et du parcours d’accueil, et vous aide à tirer le meilleur de votre plateforme Keycloak managée. En quelques minutes, votre espace de travail sera prêt pour une gestion des identités sécurisée.

Votre première connexion

Créer votre compte

Lors de votre première inscription sur Skycloak :

1. Rendez-vous sur skycloak.io et cliquez sur « Start Free Trial » (démarrer l’essai gratuit)
2. Choisissez votre méthode d’inscription :
   • E-mail et mot de passe
   • OAuth Google
   • OAuth GitHub
3. Vérifiez votre e-mail (en cas d’inscription par e-mail)
4. Choisissez votre parcours d’accueil sur l’écran de bienvenue

Le parcours d’accueil

Après l’inscription, vous arrivez sur un écran de bienvenue qui propose trois parcours. Choisissez celui qui correspond à votre façon de démarrer, ils mènent tous au même tableau de bord.

Les parcours proposés s’adaptent à votre compte, et vous pouvez sortir à tout moment grâce au lien « Skip, set it up myself » (passer, je m’en occupe moi-même) en bas de l’écran, qui vous emmène directement sur le parcours instance.

Personnaliser votre page de connexion hébergée

En haut de l’écran de bienvenue, Skycloak propose de personnaliser votre page de connexion hébergée. Si votre e-mail appartient à un domaine d’entreprise, nous le détectons ; dans tous les cas, vous pouvez téléverser votre logo sur place ou cliquer sur Skip branding (passer la personnalisation) et le faire plus tard depuis la page Branding.

Parcours 1 : Sign-in for my app’s users (environ 3 minutes)

Le moyen le plus rapide d’ajouter la connexion à une application que vous développez :

1. Choisissez votre framework dans une grille avec recherche : React, Angular, Vue, Next.js, Nuxt, SvelteKit, Node.js, Django, Spring Boot, .NET Core, FastAPI, Express, Laravel, Rails, Flask, WordPress, Drupal et bien d’autres. Chaque carte renvoie à son guide d’intégration complet.
2. Vous utilisez autre chose ? Choisissez la carte Other / Not listed (autre, non répertorié) : Skycloak crée un client et vous fournit des identifiants OIDC génériques, compatibles avec toute pile technique OIDC.
3. Copiez l’extrait de code : vous obtenez un client OIDC préconfiguré et un extrait prêt à coller pour votre framework. Vos utilisateurs peuvent se connecter dès le déploiement.

Parcours 2 : Move my existing Keycloak here (environ 10 minutes)

Pour reprendre un Keycloak que vous exploitez déjà ailleurs :

• Téléversez un export de base de données : vos données sont reprises telles quelles
• Vos realms, clients et utilisateurs suivent : la configuration existante est conservée
• Les mots de passe existants continuent de fonctionner : vos utilisateurs n’ont rien à réinitialiser

La procédure détaillée se trouve sur Migrating from Keycloak (en anglais).

Parcours 3 : New instance, I’ll set it up myself (environ 4 minutes)

Pour les équipes qui connaissent Keycloak et veulent une instance neuve avec la console complète :

• SSO vers la console d’administration : connectez-vous à la console d’administration de Keycloak avec votre compte Skycloak, sans identifiant administrateur distinct à gérer
• Extraits kcadm et Terraform : des exemples d’automatisation prêts à l’emploi pour scripter votre configuration
• Contrôle complet des indicateurs de fonctionnalités : activez ou désactivez les fonctionnalités du serveur Keycloak par cluster

Vous cherchez le SSO pour vos collaborateurs ?

Le SSO au niveau de l’espace de travail pour votre propre équipe (SAML ou OIDC vers votre fournisseur d’identité) se configure après le parcours d’accueil, depuis le tableau de bord. Voir Workspace SSO (en anglais).

Création de l’espace de travail

Configuration automatique

En parallèle du parcours d’accueil, Skycloak effectue automatiquement les opérations suivantes :

1. Création de votre espace de travail avec un identifiant unique
2. Attribution du rôle de propriétaire de l’espace de travail
3. Démarrage de votre essai gratuit : 21 jours sur le parcours applicatif (un realm entièrement managé sur le Shared Cluster) ou 7 jours sur le parcours expert (votre propre cluster dédié). Aucune carte bancaire n’est requise et les deux parcours peuvent être prolongés. Si un essai du parcours expert se termine sans souscription, le cluster dédié est mis en pause puis supprimé 7 jours plus tard. Nous vous prévenons d’abord par e-mail, et une souscription pendant cette semaine restaure tout.

Après le parcours d’accueil : votre page Clusters

À l’issue du parcours d’accueil, vous arrivez sur la page Clusters, l’accueil de votre espace de travail. Selon votre parcours, votre realm managé ou votre cluster dédié est prêt à être ouvert.

De là, les étapes essentielles sont les suivantes :

1. Vérifier votre e-mail : confirmez l’adresse e-mail de votre compte (obligatoire pour souscrire et pour Admin Console SSO)
2. Ouvrir votre realm ou votre cluster : cliquez dessus pour voir son état, ses métriques en direct et sa configuration
3. Créer votre première application : configurez l’authentification de votre application
4. Configurer les e-mails : mettez en place le SMTP pour les notifications aux utilisateurs
5. Inviter des membres d’équipe : ajoutez vos collègues depuis la page Team (équipe)

Selon votre formule, vous pouvez également :

• Ajouter un domaine personnalisé : utiliser votre propre domaine (par exemple auth.votreentreprise.com)
• Personnaliser l’apparence : adapter les pages de connexion à votre marque
• Étendre les capacités de Keycloak : installer des extensions
• Personnaliser vos modèles d’e-mail : adapter les notifications par e-mail

Passer le parcours d’accueil

Si vous rejoignez un espace de travail existant sur invitation :

• Le parcours d’accueil est automatiquement ignoré
• Vous arrivez directement sur la page Clusters de l’espace de travail
• Votre rôle et vos permissions découlent de l’invitation

Pour les utilisateurs expérimentés qui s’inscrivent :

• Utilisez « Skip onboarding for now » (passer pour l’instant) ou « Skip, set it up myself » (passer, je m’en occupe moi-même) à chaque étape du parcours d’accueil, sauf sur la page de réussite finale
• Votre espace de travail est créé automatiquement malgré tout
• Vous pouvez accéder directement aux fonctionnalités depuis la barre latérale

Conseils après le parcours d’accueil

Prenez votre temps

• Chaque étape de la liste de démarrage renvoie à un guide
• Votre progression est suivie automatiquement
• Vous pouvez traiter les tâches dans l’ordre de votre choix (certaines en supposent d’autres)

Utilisez les ressources d’aide

• Des liens vers la documentation partout dans le tableau de bord
• Le support par e-mail à support@skycloak.io
• Des info-bulles dans l’application pour les questions courantes

Schémas courants

Pour les applications grand public :

1. Commencez par la connexion sociale (Google, GitHub, etc.)
2. Ajoutez l’e-mail et le mot de passe en solution de repli
3. Activez l’inscription des utilisateurs

Pour les applications B2B :

1. Configurez le SSO d’entreprise depuis le tableau de bord après le parcours d’accueil (Workspace SSO, en anglais)
2. Configurez le contrôle d’accès basé sur les rôles
3. Imposez le MFA

Pour les outils internes :

1. Connectez-vous à Active Directory ou LDAP
2. Créez les groupes de collaborateurs
3. Définissez les politiques d’accès

Résoudre les problèmes du parcours d’accueil

Incidents fréquents

1. E-mail non reçu

   • Vérifiez les dossiers indésirables
   • Vérifiez l’adresse e-mail
   • Demandez un nouvel envoi depuis les paramètres du compte

2. Espace de travail non créé

   • Rechargez la page
   • Vérifiez votre connexion réseau
   • Contactez le support si le problème persiste

3. Parcours bloqué

   • Videz le cache du navigateur
   • Essayez un autre navigateur
   • Écrivez à support@skycloak.io

4. Message « Use a different email address » après l’inscription

   • Skycloak n’accepte pas les services d’e-mail jetables pour les nouveaux comptes
   • Inscrivez-vous de nouveau avec votre adresse professionnelle ou personnelle
   • Si votre adresse a été bloquée par erreur, écrivez à support@skycloak.io pour la réactiver

Obtenir de l’aide

Pendant le parcours d’accueil :

• 📧 E-mail : support@skycloak.io
• 📚 Des liens vers la documentation à chaque étape

Étapes suivantes

1. Créer votre cluster :

   • Créer votre premier cluster
   • Choisir votre région et la taille du cluster

2. Configurer votre application (pages en anglais) :

   • Mettre en place l’authentification
   • Tester le parcours de connexion

3. Personnaliser votre expérience (pages en anglais) :

   • Personnaliser les pages de connexion
   • Configurer un domaine personnalisé
   • Configurer les e-mails

4. Inviter votre équipe (pages en anglais) :

   • Gestion de l’équipe
   • Attribuer les rôles et les permissions

5. Superviser et optimiser (pages en anglais) :

   • Consulter l’analyse
   • Vérifier les journaux d’événements
   • Surveiller les journaux