Generar Confluence token

Para conectarse a una base de conocimientos Knowledge Hub, debe proporcionar sus credenciales a NiCE Servicios profesionales o ingresarlas Knowledge Hub 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 .

Complete cada una de estas tareas en el orden dado.

Instalar Python

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

  1. Instalar Python Cuadro con flecha que indica la navegación a un sitio externo..

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

Configurar la autenticación

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 Cuadro con flecha que indica la navegación a un sitio externo..

  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.

    Nota: 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.

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

Configurar la autenticación OAuth

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 Cuadro con flecha que indica la navegación a un sitio externo. 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 Cuadro con flecha que indica la navegación a un sitio externo..

    • 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.

    Nota: 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.
      Nota: Asegúrese de 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

Generar tokens OAuth usando Python

Utilice el script de Python de este archivo TXT para generar tokens de autenticación para acceder a la API. Antes de ejecutar el script, asegúrese de reemplazar los valores de marcador de posición para client_id y client_secret con sus credenciales reales.

Nota: Asegúrese de que los URI de redireccionamiento coincidan con los configurados en la Consola del desarrollador.

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 Cuadro con flecha que indica la navegación a un sitio externo. y genere un nuevo token.