Registro de una aplicación cliente (API rest de Azure Data Catalog)

  • Artículo

En este artículo se muestra cómo registrar una aplicación cliente de Data Catalog en Azure Active Directory (Azure AD). Para permitir que la aplicación acceda a la API rest de Data Catalog, debe registrar la aplicación con Azure Active Directory. Esta acción permite establecer una identidad para la aplicación y especificar permisos para Data Catalog recursos REST.

Importante Antes de registrar una aplicación de Data Catalog, necesita un inquilino de Azure Active Directory y un usuario organizativo.

Registro de una aplicación cliente

Registre la aplicación cliente en Azure Active Directory para establecer una identidad para la aplicación y especificar permisos para Data Catalog recursos REST. Al registrar una aplicación cliente, como una aplicación de consola, recibirá un identificador de aplicación (cliente). La aplicación usa el identificador para identificarse a sí mismo.

  1. Siga este artículo para registrar una nueva aplicación cliente en su empresa Azure Active Directory: Inicio rápido: Registro de una aplicación con el Plataforma de identidad de Microsoft

    1. Abra Azure Portal.

    2. Seleccione Azure Active Directory en el menú de la izquierda.

    3. En la sección Administrar, seleccione Registros de aplicaciones.

    4. Seleccione + Nuevo registro.

    5. Escriba un nombre para la aplicación (el nombre de la entidad de seguridad de servicio), como azure Data Catalog cuenta.

    6. Seleccione Cuentas en este directorio organizativo solo como tipo de cuenta.

    7. En el campo URI de redirección , escriba cualquier dirección URL que desee. El sitio web no tiene que existir.

    8. Después, seleccione Register (Registrar).

  2. En el nuevo registro de aplicaciones, seleccione Permisos de API. Seleccione + Agregar un permiso.

    En el Azure Portal, seleccione Solicitar permisos.

  3. En la lista de permisos, seleccione Azure Data Catalog

  4. Para elegir en ¿Qué tipo de permisos requiere la aplicación?, seleccione la opción Permisos delegados.

    En el Azure Portal, seleccione Permisos delegados.

  5. Active la casilla para conceder permiso user_impersonation. A continuación, seleccione Agregar permiso.

Obtención del identificador de aplicación (cliente)

Debe copiar los valores de Id. de aplicación (cliente) y Id. de directorio (inquilino).

Si acaba de crear el registro de aplicaciones, seleccione la página Información general del registro de aplicaciones para obtener información de identificador.

Si ya ha cerrado el registro de aplicaciones, aquí se muestra cómo encontrarlo:

  1. Abra Azure Portal.

  2. Seleccione Azure Active Directory en la lista de recursos.

  3. En el encabezado Administrar , seleccione la página Registros de aplicaciones. Una lista de Todas las aplicaciones. Seleccione la pestaña Aplicaciones propiedad para ver solo las aplicaciones que ha creado.

  4. Seleccione la fila del registro de aplicaciones que desea usar.

  5. Seleccione el identificador de aplicación (cliente). Use el botón Copiar para copiar el valor y péguelo en el Bloc de notas u otro lugar temporal.

  6. Seleccione el identificador de directorio (inquilino). Use el botón Copiar para copiar el valor y péguelo en el Bloc de notas u otro lugar temporal.

    Copia de la aplicación y el identificador de inquilino

Configuración de la entidad de servicio de Azure Data Catalog

  1. Vaya a http://www.azuredatacatalog.com.

  2. Haga clic en Configuración. A continuación, agregue la entidad de servicio al usuario del catálogo adecuado.

    En función de la necesidad empresarial, puede agregarla al administrador del glosario o al administrador delcatálogo.

    Nota

    El formato de la entidad de servicio es <clientid>@<tenantid>. Para buscar los valores que se van a insertar para los <marcadores> de posición, use la Azure Portal y abra Azure Active Directory.

    • El valor Clientid aparece en la página Azure Active Directory Registros de aplicaciones (heredado) de la columna Id. de aplicación.
    • El valor tenantID aparece en la página Propiedades de Azure Active Directory como la propiedad Id. de directorio .

  3. Siga el código de la API rest de ejemplo de autenticación de entidad de servicio para compilar la solución.