Aprenda a registrar una aplicación en Azure Active Directory (Azure AD) para su uso con la inserción de contenido de Power BI.

Deberá registrar la aplicación con Azure AD para permitir que la aplicación acceda a la API de REST de Power BI. Esto le permitirá establecer una identidad para la aplicación y especificar los permisos para los recursos de REST de Power BI.

Importante:

Antes de registrar una aplicación de Power BI, necesita un inquilino de Azure Active Directory y un usuario de la organización. Si aún no se ha registrado en Power BI con un usuario del inquilino, el registro de la aplicación no se completará correctamente.

Hay dos formas de registrar la aplicación. La primera es con la herramienta de registro de aplicaciones de Power BI o puede hacerlo también directamente en Azure Portal. La herramienta de registro de aplicaciones de Power BI es la opción más fácil, ya que hay pocos campos para rellenar. Si quiere realizar cambios en la aplicación, acceda a Azure Portal.

Registro con la herramienta de registro de aplicaciones de Power BI

Debe registrar la aplicación en Azure Active Directory para establecer una identidad para la aplicación y especificar permisos para los recursos de REST de Power BI. Al registrar una aplicación, como una aplicación de consola o un sitio web, recibirá un identificador que la aplicación usará para identificar a estos ante los usuarios a los cuales está solicitando permisos.

Aquí se muestra cómo registrar la aplicación con la herramienta de registro de aplicaciones de Power BI:

  1. Vaya a www.powerbi.com/apps.

  2. Seleccione Iniciar sesión con su cuenta existente.

  3. Proporcione un nombre de la aplicación.

  4. La selección del tipo de aplicación dependerá del tipo de aplicación que esté utilizando.

    • Use Aplicación web de servidor para las aplicaciones web o las API web.
    • Use Aplicación nativa para las aplicaciones que se ejecutan en dispositivos cliente. También debe elegir Aplicación nativa si va a insertar contenido para usuarios que no utilizan Power BI (la aplicación es propietaria de los datos) independientemente de cual sea la aplicación real.
  5. Escriba un valor para URL de redireccionamiento y URL de página principal. Funcionará cualquier dirección URL válida.

    URL de página principal solo está disponible si elige Aplicación web de servidor como tipo de aplicación.

    Para los ejemplos de App owns data y User owns data/integrate-dashboard-web-app, la URL de redireccionamiento será http://localhost:13526/redirect. Para el ejemplo de informe y de icono, la URL de redireccionamiento será http://localhost:13526/.

  6. Elija las API a las que esta aplicación tendrá acceso. Para más información sobre los permisos de acceso a Power BI, consulte Permisos de Power BI.

  7. Seleccione Registrar aplicación.

    A continuación, se le proporcionará un Id. de cliente. Si seleccionó Aplicación web de servidor, también recibirá un Secreto de cliente. El Id. de cliente se puede recuperar de Azure Portal más tarde si es necesario. Si pierde el secreto de cliente, deberá crear uno nuevo en Azure Portal.

Ahora ya puede utilizar la aplicación registrada como parte de su aplicación personalizada para interactuar con el servicio Power BI.

Importante:

Si va a insertar contenido para usuarios que no utilizan Power BI (la aplicación es propietaria de los datos), deberá configurar permisos adicionales en Azure Portal. Para más información, consulte Aplicar permisos a la aplicación.

Registro con Azure Portal

La otra opción para registrar la aplicación consiste en hacerlo directamente en Azure Portal. Para registrar la aplicación, siga estos pasos.

  1. Acepte los Términos de la API de Microsoft Power BI.

  2. Inicie sesión en Azure Portal.

  3. Elija al inquilino de Azure AD mediante la selección de la cuenta en la esquina superior derecha de la página.

  4. En el panel de navegación izquierdo, elija Mas servicios, seleccione Registros de aplicaciones en Seguridad e identidad, y seleccione Nuevo registro de aplicaciones.

  5. Siga las indicaciones y cree una nueva aplicación.

    • Para aplicaciones web, proporcione la URL de inicio de sesión, que es la dirección URL base de la aplicación, en la que los usuarios pueden iniciar sesión como, por ejemplo, http://localhost:13526.
    • Para aplicaciones nativas, proporcione un URI de redireccionamiento que usará Azure AD para devolver las respuestas de token. Escriba un valor que sea específico para la aplicación como, por ejemplo, http://myapplication/redirect

Para más información sobre cómo registrar aplicaciones en Azure Active Directory, consulte Integración de aplicaciones con Azure Active Directory

Cómo obtener el identificador de cliente

Al registrar una aplicación, recibirá un identificador de cliente. La aplicación usa el identificador de cliente para identificarse ante los usuarios a los que solicita permisos.

A continuación se indica cómo obtener un identificador de cliente:

  1. Inicie sesión en Azure Portal.

  2. Elija al inquilino de Azure AD mediante la selección de la cuenta en la esquina superior derecha de la página.

  3. En el panel de navegación izquierdo, elija Mas servicios y seleccione Registros de aplicaciones.

  4. Seleccione la aplicación de la que desea recuperar el identificador de cliente.

  5. Puede ver que el Id. de la aplicación aparece como un GUID. Este es el identificador de cliente para la aplicación.

    Identificador de cliente que aparece como identificador de la aplicación en el registro de aplicaciones

Aplicar permisos a la aplicación en Azure AD

Importante:

Esta sección solo está destinada a las aplicaciones que insertan contenido para quienes no usan Power BI (la aplicación es propietaria de los datos).

Tendrá que habilitar permisos adicionales para la aplicación, además de los proporcionados en la página de registro de la aplicación. Puede hacerlo por medio del portal de Azure AD o mediante programación.

Tendrá que iniciar sesión con la cuenta maestra, que se usó para la inserción, o con una cuenta de administrador global.

Usar el portal de Azure AD

  1. Vaya a la hoja Registros de aplicaciones en Azure Portal y seleccione la aplicación que va a usar para insertar.

  2. Seleccione Permisos necesarios en Acceso de API.

  3. Seleccione Microsoft Azure Active Directory y asegúrese de que la opción Acceder al directorio como usuario con sesión iniciada esté activada. Seleccione Guardar.

  4. En Permisos necesarios, seleccione Servicio Power BI (Power BI).

    Nota:

    Si creó la aplicación directamente en el portal de Azure AD, la opción Servicio Power BI (Power BI) puede no aparecer. Si no está, seleccione + Agregar y luego 1 Seleccionar una API. Seleccione Servicio Power BI en la lista de API y luego Seleccionar. Ahora puede continuar con el paso 5.

  5. Seleccione todos los permisos en Permisos delegados. Debe seleccionarlos uno por uno para guardar las selecciones realizadas. Seleccione Guardar cuando haya finalizado.

  6. En Permisos necesarios, seleccione Conceder permisos.

    La acción Conceder permisos es necesaria para evitar que Azure AD le solicite consentimiento a la cuenta maestra. Si la cuenta que realiza esta acción es de un administrador global, concederá permisos a todos los usuarios dentro de su organización para esta aplicación. Si la cuenta que realiza esta acción es la cuenta maestra y no es un administrador global, concederá permisos solo para la cuenta maestra de esta aplicación.

    Conceder permisos en el cuadro de diálogo de permisos necesarios

Aplicar permisos mediante programación

  1. Debe obtener las entidades de servicio (usuarios) existentes dentro de su inquilino. Para información sobre cómo hacerlo, consulte Get servicePrincipal.

    Puede llamar a la API Get servicePrincipal sin {id} y obtendrá todas las entidades de servicio en el inquilino.

  2. Busque una entidad de servicio con el identificador de cliente de aplicación como la propiedad appId.

  3. Cree un plan de servicio si la aplicación carece de él.

    Post https://graph.microsoft.com/beta/servicePrincipals
    Authorization: Bearer ey..qw
    Content-Type: application/json
    {
    "accountEnabled" : true,
    "appId" : "{App_Client_ID}",
    "displayName" : "{App_DisplayName}"
    }
    
  4. Conceda el permiso de aplicación a la API de Power BI.

    Post https://graph.microsoft.com/beta/OAuth2PermissionGrants
    Authorization: Bearer ey..qw
    Content-Type: application/json
    { 
    "clientId":"{Service_Plan_ID}",
    "consentType":"AllPrincipals",
    "resourceId":"c78b2585-1df6-41de-95f7-dc5aeb7dc98e",
    "scope":"Dataset.ReadWrite.All Dashboard.Read.All Report.Read.All Group.Read Group.Read.All Content.Create Metadata.View_Any Dataset.Read.All Data.Alter_Any",
    "expiryTime":"2018-03-29T14:35:32.4943409+03:00",
    "startTime":"2017-03-29T14:35:32.4933413+03:00"
    }
    
  5. Conceda el permiso de aplicación a AAD.

    El valor de concentType dependerá del usuario que realiza la solicitud. Puede proporcionar AllPrincipals o Principal. Solo un administrador puede usar AllPrincipals para conceder permisos a todos los usuarios. Principal se usa para conceder permiso a un usuario específico.

    La concesión de permisos es necesaria para evitar que Azure AD le solicite consentimiento a la cuenta maestra.

    Si va a usar un inquilino actual y no le interesa conceder permisos en nombre de todos sus usuarios, puede concederlos a un usuario específico reemplazando el valor de contentType por Principal.

    Post https://graph.microsoft.com/beta/OAuth2PermissionGrants
    Authorization: Bearer ey..qw
    Content-Type: application/json
    { 
    "clientId":"{Service_Plan_ID}",
    "consentType":"AllPrincipals",
    "resourceId":"61e57743-d5cf-41ba-bd1a-2b381390a3f1",
    "scope":"User.Read Directory.AccessAsUser.All",
    "expiryTime":"2018-03-29T14:35:32.4943409+03:00",
    "startTime":"2017-03-29T14:35:32.4933413+03:00"
    }
    

Pasos siguientes

Ahora que ha registrado su aplicación en Azure AD, deberá autenticar los usuarios dentro de esta. Para más información, consulte Autenticación de usuarios y obtención de un token de acceso de Azure AD para la aplicación de Power BI.

¿Tiene más preguntas? Pruebe a preguntar a la comunidad de Power BI