Registro de una aplicación de Azure AD para usarla con Power BI

En estos pasos se describe cómo registrar una aplicación de Azure AD para la solución de inserción para los clientes de Power BI.

1. Abra la herramienta de registro de aplicaciones de Power BI.

2. En la sección Choose an embedding solution (Elegir una solución de inserción), seleccione Embed for your customers (Inserción para los clientes).

3. En el Paso 1: iniciar sesión en Power BI, inicie sesión con un usuario que pertenezca a su inquilino de Power BI. La aplicación de Azure AD se registrará con este usuario.

   Si ya ha iniciado sesión, compruebe que lo haya hecho con el usuario que quiera usar para crear la aplicación de Azure AD. Para cambiar el usuario, seleccione el vínculo Cerrar sesión y, una vez que se reinicie la herramienta, vuelva a iniciar sesión.

4. En el Paso 2: registro de la aplicación, rellene los campos siguientes:

   • Nombre de la aplicación: asigne un nombre a la aplicación.

   • Acceso de API: seleccione las API de Power BI (también conocidas como ámbitos) que la aplicación necesita. Puede usar Seleccionar todo para seleccionar todas las API. Para obtener más información sobre los permisos de acceso de Power BI, vea Permisos y consentimiento en el punto de conexión de la Plataforma de identidad de Microsoft.

5. Seleccione Registrar.

   El valor Id. de aplicación de la aplicación de Azure AD se muestra en el cuadro Resumen. Copie este valor para su uso posterior.

6. (Opcional) En el Paso 3: creación de un área de trabajo, puede crear un área de trabajo en servicio Power BI.

   • Si ya tiene un área de trabajo de Power BI, seleccione Omitir.

   • Para crear un área de trabajo, escriba un nombre para el área y seleccione Crear área de trabajo. El nombre y el identificador del área de trabajo aparecen en el cuadro Resumen. Copie estos valores para su uso posterior.

   Nota

   Para que la aplicación de ejemplo de análisis de inserción funcione según lo previsto, tiene que crear un área de trabajo mediante la herramienta.

7. (Opcional) En el Paso 4: importación de contenido, seleccione una de las opciones siguientes:

   • Si tiene su propia aplicación de Power BI, puede seleccionar Omitir.

   • Si quiere crear una aplicación de Power BI de ejemplo mediante un informe de ejemplo, seleccione Sample Power BI report (Informe de Power BI de ejemplo) y, luego, Importar.

   • Si quiere crear una aplicación de Power BI de ejemplo mediante un informe propio, seleccione Upload a .pbix file (Cargar un archivo .pbix) y, luego, Importar.

8. En el Paso 5: concesión de permisos, seleccione Conceder permisos y, en la ventana emergente, seleccione Aceptar. Esto permite que la aplicación de Azure AD acceda a las API seleccionadas (también conocidas como ámbitos) con el usuario que ha iniciado sesión. Este usuario también se conoce como usuario principal.

9. (Opcional) Si ha creado un área de trabajo de Power BI y ha cargado contenido en ella mediante la herramienta, ahora puede seleccionar Download sample application (Descargar aplicación de ejemplo). Asegúrese de copiar toda la información en el cuadro Resumen.

En estos pasos se describe cómo registrar una aplicación de Azure AD para la solución de inserción para la organización de Power BI.

1. Abra la herramienta de registro de aplicaciones de Power BI.

2. En la sección Choose an embedding solution (Elegir una solución de inserción), seleccione Embed for your organization (Inserción para la organización).

3. En el Paso 1: iniciar sesión en Power BI, inicie sesión con un usuario que pertenezca a su inquilino de Power BI. La aplicación de Azure AD se registrará con este usuario.

   Si ya ha iniciado sesión, compruebe que lo haya hecho con el usuario que quiera usar para crear la aplicación de Azure AD. Para cambiar el usuario, seleccione el vínculo Cerrar sesión y, una vez que se reinicie la herramienta, vuelva a iniciar sesión.

4. En el Paso 2: registro de la aplicación, rellene los campos siguientes:

   • Nombre de la aplicación: asigne un nombre a la aplicación.

   • Dirección URL de la página principal: escriba una dirección URL de la página principal.

   • URL de redireccionamiento: tras iniciar sesión, se redirigirá a los usuarios de la aplicación a esta dirección, mientras la aplicación recibe un código de autenticación de Azure. Seleccione una de estas opciones:

     • Use a default URL (Usar una URL predeterminada): esta opción creará y descargará automáticamente una aplicación de análisis insertada de ejemplo. La dirección URL predeterminada es http://localhost:13526/.

     • Use a custom URL (Usar una URL personalizada): seleccione esta opción si ya tiene una aplicación de análisis insertada y sabe qué quiere usar como URL de redireccionamiento.

   • Acceso de API: seleccione las API de Power BI (también conocidas como ámbitos) que la aplicación necesita. Puede usar Seleccionar todo para seleccionar todas las API. Para obtener más información sobre los permisos de acceso de Power BI, vea Permisos y consentimiento en el punto de conexión de la Plataforma de identidad de Microsoft.

5. Seleccione Registrar.

   Los valores Id. de aplicación y Secreto de aplicación de la aplicación de Azure AD se muestran en el cuadro Resumen. Copie estos valores para su uso posterior.

6. (Opcional) En el Paso 3: creación de un área de trabajo, puede crear un área de trabajo en servicio Power BI.

   • Si ya tiene un área de trabajo de Power BI, seleccione Omitir.

   • Para crear un área de trabajo, escriba un nombre para el área y seleccione Crear área de trabajo. El nombre y el identificador del área de trabajo aparecen en el cuadro Resumen. Copie estos valores para su uso posterior.

   Nota

   Para que la aplicación de ejemplo de análisis de inserción funcione según lo previsto, tiene que crear un área de trabajo mediante la herramienta.

7. (Opcional) En el Paso 4: importación de contenido, seleccione una de las opciones siguientes:

   • Si tiene su propia aplicación de Power BI, puede seleccionar Omitir.

   • Si quiere crear una aplicación de Power BI de ejemplo mediante un informe de ejemplo, seleccione Sample Power BI report (Informe de Power BI de ejemplo) y, luego, Importar.

   • Si quiere crear una aplicación de Power BI de ejemplo mediante un informe propio, seleccione Upload a .pbix file (Cargar un archivo .pbix) y, luego, Importar.

8. (Opcional) Si ha creado un área de trabajo de Power BI y ha cargado contenido en ella mediante la herramienta, ahora puede seleccionar Download sample application (Descargar aplicación de ejemplo). Asegúrese de copiar toda la información en el cuadro Resumen.

Use el registro manual de la aplicación de Azure AD solo si va a crear una de las siguientes soluciones:

• Una aplicación de inserción para la organización.

• Una aplicación de inserción para los clientes con una entidad de servicio.

  Nota

  Si elige esta opción, después de registrar la aplicación de Azure AD deberá agregarle permisos de Power BI.

Para obtener más información sobre cómo registrar aplicaciones en Azure Active Directory, consulte Registro de una aplicación en Azure Active Directory.

1. Inicie sesión en el Portal de Azure.

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

3. Seleccione App registrations (Registros de aplicaciones). Si no puede ver esta opción, búsquela.

4. En Registros de aplicaciones, seleccione Nuevo registro.

5. Rellene los campos siguientes:

   • Nombre: asigne un nombre a la aplicación.

   • Supported account type (Tipo de cuenta admitido): seleccione quién puede usar la aplicación.

6. (Opcional) En el URI de redireccionamiento, agregue una dirección URL de redireccionamiento.

7. Seleccione Registrar. Una vez registrada la aplicación, se le dirigirá a la página de información general de la aplicación, donde puede obtener el valor Id. de aplicación.

En Azure Portal, puede ver la aplicación y realizar cambios en los permisos.

1. Inicie sesión en el Portal de Azure.

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

3. Seleccione App registrations (Registros de aplicaciones). Si no puede ver esta opción, búsquela.

4. En la pestaña Aplicaciones propias, seleccione la aplicación. La aplicación se abre en la pestaña Información general, donde puede revisar el valor Id. de la aplicación.

5. Seleccione la pestaña Permisos de API.

6. Para agregar permisos, siga estos pasos:

   1. Seleccione Agregar un permiso y, luego, Servicio Power BI.

   2. Seleccione Permisos delegados, y agregue o quite los permisos específicos que necesite.

   3. Cuando haya terminado, seleccione Agregar permisos para guardar los cambios.

7. Para quitar un permiso, siga estos pasos:

   1. Seleccione los puntos suspensivos (…) situados a la derecha del permiso.

   2. Seleccione Quitar permiso.

   3. En la ventana emergente Quitar permiso, seleccione Sí, quitar.

Para cambiar los permisos de la aplicación de Azure AD mediante programación, deberá obtener las entidades de servicio (usuarios) existentes en el inquilino. Para información sobre cómo hacerlo, consulte servicePrincipal.

1. Para obtener todas las entidades de servicio del inquilino, llame a la API Get servicePrincipal sin {ID}.

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

   Post https://graph.microsoft.com/v1.0/servicePrincipals HTTP/1.1
   Authorization: Bearer ey..qw
   Content-Type: application/json
   {
   "accountEnabled" : true,
   "appId" : "{App_Client_ID}",
   "displayName" : "{App_DisplayName}"
   }
   

   Nota

   displayName es opcional.

3. Conceda permisos de Power BI a la aplicación. Para ello, asigne uno de estos valores a consentType:

   • AllPrincipals: solo lo puede usar un administrador de Power BI para conceder permisos en nombre de todos los usuarios del inquilino.

   • Principal: se usa para conceder permisos en nombre de un usuario específico. Si usa esta opción, agregue la propiedad principalId={User_ObjectId} al cuerpo de la solicitud.

   Post https://graph.microsoft.com/v1.0/OAuth2PermissionGrants HTTP/1.1
   Authorization: Bearer ey..qw
   Content-Type: application/json
   {
   "clientId":"{Service_Plan_ID}",
   "consentType":"AllPrincipals",
   "resourceId":"c78a3685-1ce7-52cd-95f7-dc5aea8ec98e",
   "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"
   }
   

   Nota

   • Si usa un usuario principal, para evitar que Azure AD le pida consentimiento, debe conceder permisos a la cuenta maestra.
   • El valor resourceId c78a3685-1ce7-52cd-95f7-dc5aea8ec98e depende del inquilino y no es universal. Este valor es el elemento objectId de la aplicación Servicio Power BI en Azure AD. Para obtener este valor en Azure Portal, vaya a Aplicaciones empresariales > Todas las aplicaciones y busque Servicio Power BI.

4. Conceda permisos de aplicación a Azure AD mediante la asignación de un valor a consentType.

   Post https://graph.microsoft.com/v1.0/OAuth2PermissionGrants HTTP/1.1
   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"
   }
   

También puede cambiar los permisos de la aplicación de Azure AD mediante C#. Para más información, vea la API oAuth2PermissionGrant. Este método puede ser útil si está pensando en automatizar algunos de los procesos.

Para obtener más información sobre las solicitudes HTTP, consulte la pestaña HTTP.

var graphClient = GetGraphClient();

currentState.createdApp = await graphClient.Applications
    .Request()
    .AddAsync(application);

System.Threading.Thread.Sleep(2000);

var passwordCredential = new PasswordCredential
{
    DisplayName = "Client Secret Created in C#"
};

currentState.createdSecret = await graphClient.Applications[currentState.createdApp.Id]
    .AddPassword(passwordCredential)
    .Request()
    .PostAsync();

var servicePrincipal = new ServicePrincipal
{
    AppId = currentState.createdApp.AppId
};

currentState.createdServicePrincipal = await graphClient.ServicePrincipals
    .Request()
    .AddAsync(servicePrincipal);

GraphServiceClient graphClient = new GraphServiceClient(authProvider);

// Use oAuth2PermissionGrant to change permissions
var oAuth2PermissionGrant = await graphClient.Oauth2PermissionGrants["{id}"]
               .Request()
               .GetAsync();