Conector de Microsoft Graph wiki de Azure DevOps
El conector de Wiki Graph de Azure DevOps permite a su organización indexar wikis en su instancia del servicio Azure DevOps. Después de configurar el conector, los usuarios finales pueden buscar wikis de proyecto y wikis de código de Azure DevOps en Microsoft Search.
Nota:
- Lea el artículo Configuración del conector de Graph para conocer las instrucciones generales de configuración de los conectores de Graph.
Este artículo está destinado a cualquier persona que configure, ejecute y supervise un conector de Wiki Graph de Azure DevOps. Complementa el proceso de instalación general y muestra instrucciones que solo se aplican al conector de Wiki Graph de Azure DevOps.
Importante
El conector wiki de Azure DevOps solo admite el servicio en la nube de Azure DevOps. Azure DevOps Server 2019, TFS 2018, TFS 2017, TFS 2015 y TFS 2013 no son compatibles con este conector.
Antes de empezar
Debe ser el administrador de búsqueda del inquilino M365 de la organización, así como el administrador de la instancia de Azure DevOps de la organización.
Para permitir que el conector se conecte a la organización de Azure DevOps, debe habilitar el acceso a aplicaciones de terceros a través de OAuth. Consulte la documentación de Azure DevOps para administrar directivas de seguridad para obtener más información.
Necesitará los siguientes permisos concedidos a la cuenta de usuario cuyas credenciales se usan durante la configuración del conector:
Nombre del permiso | Tipo de permiso | Requerido para |
---|---|---|
Visualización de información de nivel de proyecto | Permiso de proyecto | Rastreo de elementos de trabajo de Azure DevOps. Este permiso es obligatorio para los proyectos que deben indexarse. |
Importante
La cuenta de usuario debe tener el nivel de acceso Básico . Para más información sobre los niveles de acceso en Azure DevOps, lea los niveles de acceso admitidos.
Paso 1: Agregar un conector de Graph en el Centro de administración de Microsoft 365
Incorporación del conector wiki de Azure DevOps
Siga las instrucciones generales de configuración.
Paso 2: Asignar un nombre a la conexión
Siga las instrucciones generales de configuración.
Paso 3: Configurar las opciones de conexión
Para conectarse a la instancia de Azure DevOps, necesita el identificador de aplicación y el secreto de cliente de la cuenta de Azure DevOps para la autenticación de OAuth.
Registrar una aplicación
Registre una aplicación en Azure DevOps para que la aplicación Microsoft Search pueda acceder a la instancia. Para registrar la aplicación, visite el vínculo para registrar la aplicación. Para más información, consulte la documentación de Azure DevOps sobre cómo registrar una aplicación.
En la tabla siguiente se proporcionan instrucciones sobre cómo rellenar el formulario de registro de aplicaciones:
Campos obligatorios | Descripción | Valor recomendado |
---|---|---|
Nombre de la compañía | Nombre de la empresa. | Uso de un valor adecuado |
Nombre de la aplicación | Valor único que identifica la aplicación que está autorizando. | Búsqueda de Microsoft |
Sitio web de la aplicación | Dirección URL de la aplicación que solicitará acceso a la instancia de Azure DevOps durante la instalación del conector. (Obligatorio). | Para M365 Enterprise: https:// gcs.office.com/, para M365 Government: https:// gcsgcc.office.com/ |
Dirección URL de devolución de llamada de autorización | Dirección URL de devolución de llamada necesaria a la que redirige el servidor de autorización. | Para M365 Enterprise: https:// gcs.office.com/v1.0/admin/oauth/callback, Para M365 Government: https:// gcsgcc.office.com/v1.0/admin/oauth/callback |
Ámbitos autorizados | Ámbito de acceso de la aplicación | Seleccione los ámbitos siguientes: Identidad (lectura), Código (lectura), Derechos (lectura), Proyecto y equipo (lectura), Grafo (lectura), Administración de memberEntitlement (lectura), Wiki (lectura) |
Importante
Los ámbitos autorizados seleccionados para la aplicación deben coincidir exactamente con los ámbitos enumerados anteriormente. Si se seleccionan más o menos ámbitos, se producirá un error en la autorización.
Al registrar la aplicación con los detalles anteriores, obtendrá el identificador de aplicación y el secreto de cliente que se usarán para configurar el conector.
Nota:
Para revocar el acceso a cualquier aplicación registrada en Azure DevOps, vaya a Configuración de usuario en la parte superior derecha de la instancia de Azure DevOps. Seleccione Perfil y, a continuación, seleccione Autorizaciones en la sección Seguridad del panel lateral. Mantenga el puntero sobre una aplicación OAuth autorizada para ver el botón Revocar en la esquina de los detalles de la aplicación.
Configuración de conexión
Después de registrar la aplicación Microsoft Search con Azure DevOps, puede completar el paso de configuración de conexión. Escriba el identificador de la aplicación y el secreto de cliente.
Configurar datos: seleccionar organización, proyectos y campos
En este paso, especificará el ámbito de los datos que desea indexar mediante el conector de grafos wiki de Azure DevOps.
Como primer paso, puede elegir la organización a la que desea indexar, de todas las organizaciones a las que tiene acceso. A continuación, puede elegir la conexión para indexar toda la organización o proyectos específicos dentro de la organización seleccionada.
Si decide indexar toda la organización, se indexarán las wikis de todos los proyectos de la organización. Los nuevos proyectos y wikis se indexarán durante el siguiente rastreo después de crearse.
Si decide indexar proyectos individuales, solo se indexarán las wikis de los proyectos seleccionados.
Paso 4: Administrar permisos de búsqueda
El conector de Azure DevOps admite permisos de búsqueda visibles para todos. Con la opción Todos , los datos indexados aparecerán en los resultados de búsqueda de todos los usuarios.
Paso 5: Asignar etiquetas de propiedad
Siga las instrucciones generales de configuración.
Paso 6: Administrar esquema
Siga las instrucciones generales de configuración.
Paso 7: Elegir la configuración de actualización
El conector Wiki de Azure DevOps admite programaciones de actualización para rastreos completos e incrementales. La programación recomendada es de una hora para un rastreo incremental y una semana para un rastreo completo.
Paso 8: Revisión de la conexión
Siga las instrucciones generales de configuración.
Paso 9: Configurar la página de resultados de búsqueda
Después de publicar la conexión, debe personalizar la página de resultados de búsqueda con verticales y tipos de resultados. Para obtener información sobre cómo personalizar los resultados de la búsqueda, revise cómo administrar los tipos de resultados y verticales. También puede usar el diseño de resultados de ejemplo para el conector Wiki de Azure DevOps. Simplemente copie y pegue el json de diseño de resultados para empezar.
Solución de problemas
Los siguientes son errores comunes observados al configurar el conector, o durante el rastreo, y sus posibles motivos.
Paso | Mensaje de error | Motivos posibles |
---|---|---|
Configuración de conexión | Invalid Credentials detected. Try signing in with a different account or check the permissions for your account |
Es posible que se deshabilite el acceso a aplicaciones de terceros a través de OAuth. Siga los pasos para administrar las directivas de seguridad para habilitar OAuth. |
Configuración de conexión | Bad state mensaje en la ventana emergente de OAuth con dirección URL que indica error=InvalidScope |
Ámbitos incorrectos proporcionados a la aplicación registrada. |
Configuración de conexión | 400 - Bad request mensaje en la ventana emergente de OAuth |
Identificador de aplicación incorrecto |
Configuración de conexión | BadRequest: Bad Request on api request mensaje en la ventana emergente de OAuth |
Secreto de cliente incorrecto |
Tiempo de rastreo (configuración posterior al conector) | The account associated with the connector doesn't have permission to access the item. |
La aplicación registrada no tiene ninguno de los ámbitos de OAuth necesarios. |
Tiempo de rastreo (configuración posterior al conector) | You don't have permission to access this data source. You can contact the owner of this data source to request permission. |
El acceso a aplicaciones de terceros a través de OAuth está deshabilitado. Siga los pasos para administrar las directivas de seguridad para habilitar OAuth. |
Tiempo de rastreo (configuración posterior al conector) | Credentials associated with this data source have expired. Renew the credentials and then update the connection |
Es posible que la aplicación registrada se haya eliminado o expirado. |
Tiempo de rastreo (configuración posterior al conector) | Item listed but no longer accessible or no longer exists |
Es posible que a la cuenta de rastreo le falte el nivel de acceso "Básico". Se produce un error en los rastreos con acceso "Stakeholder". |