Générer un jeton Confluence

Pour vous connecter à une base de connaissances Knowledge Hub, vous devez soit fournir vos identifiants aux NiCE Services professionnels, soit les saisir vous-même dans Knowledge Hub. Cette page décrit comment générer ces informations d'identification, aussi appelées jetons OAuth. Vous devez traiter les jetons OAuth comme des mots de passe. Assurez-vous de les ranger dans un endroit sûr. Si vous les perdez, vous devrez les régénérer.

Cette méthode est un effort de développeur. Cela nécessite la connaissance de Python et des privilèges d'administrateur Atlassian .

Effectuez chacune de ces tâches dans l’ordre indiqué.

Installer Python

Effectuez cette tâche si Python n’est pas déjà installé sur votre ordinateur.

  1. Installez Python Boîte avec une flèche indiquant la navigation vers un site externe..

  2. Exécutez le programme d'installation. Sélectionnez la case Ajouter python.exe au CHEMIN, puis cliquez sur Installer maintenant.

Configurer l'authentification

Utilisez cette méthode pour l'intégration de base avec Confluence. Pour créer un jeton d'API, procédez comme suit :

  1. Accédez à la page des paramètres du compte Atlassian.Boîte avec une flèche indiquant la navigation vers un site externe.

  2. Sélectionnez l’onglet Sécurité.

  3. Sur la page API Tokens, sélectionnez Créer un jeton API.

  4. Dans la boîte de dialogue Créer un jeton d'API :

    • Entrez un nom pour le jeton.

    • Précisez la date d'expiration du jeton.

    • Sélectionnez Créer.

    Le système génère un jeton API.

    Remarque : les jetons API peuvent être valides jusqu’à un an. Assurez-vous de les renouveler avant leur expiration afin d'éviter toute interruption.

  5. Copiez le jeton et gardez-le dans un endroit sûr.

    Remarque : Vous ne pourrez plus voir le jeton après avoir fermé la boîte de dialogue.

Configurer l'authentification OAuth

Pour configurer l'authentification OAuth, suivez ces étapes pour activer un accès sûr et limité à Confluence à l'aide d'une méthode de connexion sécurisée appelée OAuth 2.0.

  1. Allez à la Atlassian Developer Console Boîte avec une flèche indiquant la navigation vers un site externe. et connectez-vous avec votre compte Atlassian.

  2. Créez ou sélectionnez votre application :

    • Si vous n'avez pas créé d'application :

      • Sélectionnez Créer.

      • Dans le menu déroulant, choisissez OAuth 2.0 (3LO) comme type d'application.

      • Entrez un nom et une description pour votre application.

      • Sélectionnez Créer pour terminer.

    • Si vous avez déjà une application :

      • Sélectionnez l'application dans la liste Mes applications.

  3. Accédez à la page Aperçu de l’application, dans le volet de navigation de gauche, sélectionnez Autorisations.

    • Sous API Confluence, sélectionnez Ajouter, puis choisissez Configurer.

    • Activez les autorisations requises :

      • Pour les étendues Classiques, sélectionnez Modifier et activez toutes les permissions de lecture.

      • Pour les étendues Granular, sélectionnez Edit et activez toutes les permissions de lecture.

    • Sélectionnez Enregistrer pour appliquer les paramètres de portée.

  4. Dans le volet de navigation de gauche, sélectionnez Autorisation.

    • Sous OAuth 2.0 (3LO), sélectionnez Ajouter.

    • Dans le champ URL de rappel , entrez :

      • https://us-west-2.console.aws.amazon.com/appflow/oauth

    • Sélectionnez Enregistrer les modifications.

  5. Dans le volet de navigation de gauche, sélectionnez Paramètres.

  6. Allez dans la section Détails d'authentification et copiez l'ID client et la clé secrète.

Configurer l'accès des utilisateurs et des groupes

Cette section explique comment ajouter des utilisateurs, attribuer l'accès au produit et gérer les appartenances aux groupes dans la console d'administration Atlassian pour garantir un accès approprié à Confluence.

  1. Pour ajouter des utilisateurs :

    • Allez à la console d'administration Atlassian Boîte avec une flèche indiquant la navigation vers un site externe..

    • Dans le volet de navigation de gauche, sélectionnez Répertoire, puis choisissez Utilisateurs.

    • Sélectionnez Inviter les utilisateurs.

    • Entrez les adresses courriel des utilisateurs que vous souhaitez inviter.

    • Sous Accès au produit, sélectionnez Confluence pour accorder l'accès au site.

    • Sélectionnez Envoyer l'invitation.

    Remarque : Les utilisateurs doivent accepter l’invitation pour activer leurs comptes.

  2. Une fois les utilisateurs ajoutés, assignez-leur les rôles produits appropriés afin de contrôler leur niveau d'accès. Pour assigner l'accès au produit :

    • Dans la liste Utilisateurs, sélectionnez le nom de l'utilisateur.

    • Sur la page du profil utilisateur, sélectionnez l'onglet Accès au produit.
      Remarque : Assurez-vous que Confluence est sélectionné.

    • Attribuez le rôle approprié en fonction des responsabilités de l'utilisateur. Par exemple, utilisateur, administrateur, etc.

  3. Pour ajouter des utilisateurs à des groupes

    • Dans le volet de navigation de gauche, sélectionnez Répertoire, puis choisissez Groupes.

    • Sélectionnez le groupe que vous souhaitez gérer.

    • Sélectionnez Ajouter des membres.

    • Recherchez les utilisateurs par nom ou adresse courriel.

    • Sélectionnez les utilisateurs et confirmez l'ajout.

    L'accès par groupe simplifie la gestion des autorisations sur plusieurs espaces et produits.

  4. Les appartenances à des groupes permettent de gérer efficacement les autorisations et les niveaux d'accès. Les Groupes recommandés sont les suivants :

    Nom du groupe

    OBJECTIF
    confluence-admins-servion11 Accès administrateur
    confluence-user-access-admins-servion11 Gérer l'accès des utilisateurs

    confluence-users-servion11

    		Accès général à l'utilisateur
    org-admins Administrateur au niveau de l'organisation

Générer OAuth jetons à l'aide de Python

Utilisez le script Python de ce fichier TXT pour générer des jetons d'authentification pour accéder à l'API. Avant d'exécuter le script, assurez-vous de remplacer les valeurs d'espace réservé pour client_id et client_secret par vos véritables informations d'identification.

Remarque : Assurez-vous que les URI de redirection correspondent à celle configurée dans la console de développement.

Configurer les Autorisations au niveau de l'espace dans Confluence

Les permissions au niveau de l'espace dans Confluence vous permettent de contrôler qui peut consulter, modifier ou administrer le contenu d'un espace spécifique. Suivez ces étapes pour configurer les autorisations d'un espace :

  1. Connectez-vous à votre espace Confluence en utilisant vos identifiants.

  2. Dans le volet de navigation de gauche, repérez et cliquez sur l'espace que vous voulez gérer.

  3. Dans l'espace, cliquez sur Paramètres de l'espace.

  4. Faites défiler jusqu'à la section Accès à l'espace et cliquez sur Utilisateurs. Cela ouvre l'interface permettant d'ajouter ou de supprimer des autorisations pour un utilisateur ou un groupe d'utilisateurs.

  5. Cliquez sur Modifier et activez l'accès Afficher.

  6. Après avoir attribué les autorisations appropriées, cliquez sur Enregistrer.

Expiration du jeton d'accès

Si votre jeton d'accès a expiré, vous ne pourrez pas faire d'appels API. Pour résoudre ce problème, allez à la console de développement Atlassian et générez un nouveau jeton.Boîte avec une flèche indiquant la navigation vers un site externe.