Generar Confluence token

Para conectar Confluence a una base de conocimientos Knowledge, debe proporcionar sus credenciales a NiCE Servicios profesionales o ingresarlas Knowledge usted mismo. Esta página describe cómo generar esas credenciales, también llamadas tokens OAuth. Debes tratar los tokens OAuth como contraseñas. Asegúrese de guardarlos en un lugar seguro. Si los pierdes, tendrás que regenerarlos.

Este método es un esfuerzo del desarrollador. Requiere conocimientos de Python y privilegios de administrador de Atlassian.

Instalar Python

Complete esta tarea si aún no tiene Python instalado en su computadora.

1. Instalar Python .

2. Ejecute el instalador. Seleccione la casilla Agregar python.exe a RUTA, luego haga clic en Instalar ahora.

Configurar la autenticación

Puede autenticar Confluence con Knowledge utilizando uno de los siguientes métodos:

• Configurar la autenticación (método de token API)

• Configurar la autenticación OAuth (OAuth 2.0 3LO)

Configurar la autenticación básica (método de token API)

Utilice este método para la integración básica con Confluence. Para crear un token de API, haga lo siguiente:

1. Vaya a la página Configuración de la cuenta Atlassian .

2. Seleccione la pestaña Seguridad.

3. En la página Tokens de API, seleccione Crear token de API.

4. En el cuadro de diálogo Crear token de API:

   • Introduzca un nombre para el token.

   • Especifique el tiempo de expiración del token.

   • Seleccione Crear.

   El sistema genera un token API.

   Los tokens API pueden ser válidos hasta por un año. Asegúrese de renovarlos antes de que caduquen para evitar interrupciones.

5. Copie el token y guárdelo en un lugar seguro.

   No podrás volver a ver el token después de cerrar el cuadro de diálogo.

Configurar la autenticación OAuth (OAuth 2.0 3LO)

Para configurar la autenticación OAuth, siga estos pasos para habilitar el acceso seguro y limitado a Confluence utilizando un método de inicio de sesión seguro llamado OAuth 2.0.

1. Vaya a la Consola para desarrolladores de Atlassian e inicie sesión con su cuenta de Atlassian.

2. Crea o selecciona tu aplicación:

   • Si no tienes una aplicación creada:

     • Seleccione Crear.

     • En el menú desplegable, elija OAuth 2.0 (3LO) como tipo de aplicación.

     • Ingrese un nombre y una descripción para su aplicación.

     • Seleccione Crear para finalizar.

   • Si ya tienes una aplicación:

     • Seleccione la aplicación de la lista Mis aplicaciones.

3. Vaya a la página Descripción general de la aplicación, en el panel de navegación izquierdo, seleccione Permisos.

   • En Confluence API, seleccione Agregar y luego elija Configurar.

   • Habilite los ámbitos requeridos:

     • Para los ámbitos Clásico, seleccione Editar y habilite todos los permisos de lectura.

     • Para los ámbitos Granular, seleccione Editar y habilite todos los permisos de lectura.

   • Seleccione Guardar para aplicar la configuración del alcance.

4. En el panel de navegación izquierdo, seleccione Autorización.

   • En OAuth 2.0 (3LO), seleccione Agregar.

   • En el campo URL de devolución de llamada, ingrese:

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

   • Seleccione Guardar cambios.

5. En el panel de navegación izquierdo, seleccione Configuración.

6. Vaya a la sección Detalles de autenticación y copie el ID de cliente y la Clave secreta.

Configurar el acceso de usuarios y grupos

En esta sección se explica cómo agregar usuarios, asignar acceso a productos y administrar membresías de grupos en la Consola de administración de Atlassian para garantizar un acceso adecuado a Confluence.

1. Para agregar usuarios:

   • Vaya a laConsola de administración de Atlassian .

   • En el panel de navegación izquierdo, seleccione Directorio y luego elija Usuarios.

   • Seleccione Invitar usuarios.

   • Introduzca las direcciones de correo electrónico de los usuarios que desea invitar.

   • En Acceso al producto, seleccione Confluence para otorgar acceso al sitio.

   • Seleccione Enviar invitación.

   Los usuarios deben aceptar la invitación para activar sus cuentas.

2. Una vez agregados los usuarios, asigne los roles de producto adecuados para controlar su nivel de acceso. Para asignar acceso al producto:

   • En la lista Usuarios, seleccione el nombre del usuario.

   • En la página de perfil de usuario, seleccione la pestaña Acceso al producto.

     Confirme que Confluence esté seleccionado.

   • Asignar el rol apropiado según las responsabilidades del usuario. Por ejemplo, usuario, administrador, etc.

3. Para agregar usuarios a grupos

   • En el panel de navegación izquierdo, seleccione Directorio y luego elija Grupos.

   • Seleccione el grupo que desea administrar.

   • Seleccione Agregar miembros.

   • Busque usuarios por nombre o dirección de correo electrónico.

   • Seleccione los usuarios y confirme la adición.

   El acceso basado en grupos simplifica la gestión de permisos en múltiples espacios y productos.

4. Las membresías de grupo ayudan a administrar los permisos y los niveles de acceso de manera eficiente. Los Grupos recomendados son los siguientes:

   Nombre del GRUPO	OBJETIVO
   confluence-admins-servion11	Acceso de administrador
   confluence-usuario-acceso-admins-servion11	Administrar el acceso de los usuarios
   confluence-users-servion11	Acceso de usuario general
   administradores de la organización	Administrador a nivel de organización

Ejecutar el script de Python

Por último, ejecute un script de Python para recuperar su token de acceso Confluence.

1. Abra un editor de texto e inicie un archivo Python.

2. Copie y pegue las líneas de código de este archivo TXT en su archivo Python.

3. Reemplace los valores de marcador de posición para client_id y client_secret con sus credenciales reales.

4. Abra cualquier IDE y ejecute el script de Python.

Configurar Permisos a nivel de espacio en Confluence

Los permisos a nivel de espacio en Confluence le permiten controlar quién puede ver, editar o administrar contenido dentro de un espacio específico. Siga estos pasos para configurar los permisos de un espacio:

1. Inicie sesión en su espacio Confluence usando sus credenciales.

2. En el panel de navegación izquierdo, busque y haga clic en el espacio que desea administrar.

3. Dentro del espacio, haga clic en Configuración del espacio.

4. Desplácese hasta la sección Acceso al espacio y haga clic en Usuarios. Esto abre la interfaz donde puede agregar o eliminar permisos para un usuario o grupo de usuarios.

5. Haga clic en Editar y habilite el acceso Ver.

6. Después de asignar los permisos adecuados, haga clic en Guardar.

Vencimiento del token de acceso

Si su token de acceso ha expirado, no podrá realizar llamadas API. Para solucionar esto, vaya a la AtlassianDeveloper Console y genere un nuevo token.