Registro de una aplicación de Azure AD para usarla con Power BIRegister an Azure AD application to use with Power BI

Para usar el análisis de Power BI Embedded, debe registrar una aplicación de Azure Active Directory (Azure AD) en Azure.To use Power BI embedded analytics, you need to register an Azure Active Directory (Azure AD) application in Azure. La aplicación de Azure AD establece permisos para los recursos REST de Power BI y permite el acceso a las API REST de Power BI.The Azure AD app establishes permissions for Power BI REST resources, and allows access to the Power BI REST APIs.

Determinación de la solución de inserciónDetermine your embedding solution

Antes de registrar la aplicación, decida cuál de las siguientes soluciones es la más adecuada para usted:Before registering your app, decide which of the following solutions is best suited for you:

  • Inserción para los clientesEmbed for your customers
  • Inserción para la organizaciónEmbed for your organization

Inserción para los clientesEmbed for your customers

Use la solución de inserción para los clientes, lo que también se conoce como aplicación poseedora de los datos, si tiene previsto crear una aplicación diseñada para los clientes.Use the embed for your customers solution, also known as app owns data, if you're planning to create an application that's designed for your customers. Los usuarios no tendrán que iniciar sesión en Power BI ni disponer de una licencia de Power BI para usar la aplicación.Users will not need to sign in to Power BI or have a Power BI license, to use your application. La aplicación usará uno de los métodos siguientes para autenticarse en Power BI:Your application will use one of the following methods to authenticate against Power BI:

  • Cuenta de usuario principal (licencia de Power BI Pro usada para iniciar sesión en Power BI)Master user account (a Power BI Pro license used for signing in to Power BI)

  • Entidad de servicioService principal

Los fabricantes de software independientes (ISV) y los desarrolladores que crean aplicaciones para terceros suelen usar la solución de inserción para los clientes.The embed for your customers solution is usually used by independent software vendors (ISVs) and developers who are creating applications for a third party.

Inserción para la organizaciónEmbed for your organization

Use la solución de inserción para la organización, lo que también se conoce como usuario poseedor de los datos, si tiene previsto crear una aplicación que requiera que los usuarios empleen sus credenciales para autenticarse en Power BI.Use the embed for your organization solution, also known as user owns data, if you're planning to create an application that requires users to use their credentials to authenticate against Power BI.

La solución de inserción para la organización suelen usarla empresas y organizaciones de gran tamaño, y está pensada para los usuarios internos.The embed for your organization solution is usually used by enterprises and big organizations, and is intended for internal users.

Registrar una aplicación de Azure ADRegister an Azure AD app

La forma más fácil de registrar una aplicación de Azure AD es mediante la herramienta de configuración de la inserción de Power BI.The easiest way to register an Azure AD app, is by using the Power BI embedding setup tool. La herramienta ofrece un proceso de registro rápido para ambas soluciones de inserción mediante una simple interfaz gráfica.The tool offers a quick registration process for both embedding solutions, using a simple graphical interface.

Si va a crear una aplicación de inserción para la organización y quiere tener más control sobre la aplicación de Azure AD, puede registrarla manualmente en Azure Portal.If you're creating an embed for your organization application, and want more control over your Azure AD app, you can register it manually in the Azure portal.

Importante

Antes de registrar una aplicación de Power BI, necesita un inquilino de Azure Active Directory y un usuario de la organización.Before you register a Power BI app you need an Azure Active Directory tenant and an organizational user.

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.These steps describe how to register an Azure AD application for the Power BI embed for your customers solution.

  1. Abra la herramienta de registro de aplicaciones de Power BI.Open the Power BI App Registration Tool.
  1. 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).In the Choose an embedding solution section, select Embed for your customers.
  1. En el Paso 1: iniciar sesión en Power BI, inicie sesión con un usuario que pertenezca a su inquilino de Power BI.In Step 1 - sign in to Power BI, sign in with a user that belongs to your Power BI tenant. La aplicación de Azure AD se registrará con este usuario.The Azure AD app will be registered under this user.

    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.If you're already signed in, verify that you're signed in with the user you want to use for creating the Azure AD app. Para cambiar el usuario, seleccione el vínculo Cerrar sesión y, una vez que se reinicie la herramienta, vuelva a iniciar sesión.To change a user, select the sign out link and once the tool restarts, sign in again.

  1. En el Paso 2: registro de la aplicación, rellene los campos siguientes:In Step 2 - Register your application, fill in the following fields:

  2. Seleccione Registrar.Select Register.

    El valor Id. de aplicación de la aplicación de Azure AD se muestra en el cuadro Resumen.Your Azure AD app Application ID is displayed in the Summary box. Copie este valor para su uso posterior.Copy this value for later use.

  1. (Opcional) En el Paso 3: creación de un área de trabajo, puede crear un área de trabajo en servicio Power BI.(Optional) In Step 3 - Create a workspace, you can create a workspace in Power BI service.

    • Si ya tiene un área de trabajo de Power BI, seleccione Omitir.If you already have a Power BI workspace, select Skip.

    • Para crear un área de trabajo, escriba un nombre para el área y seleccione Crear área de trabajo.To create a workspace, enter a name for your workspace and select Create workspace. El nombre y el identificador del área de trabajo aparecen en el cuadro Resumen.Your Workspace name and ID appear in the Summary box. Copie estos valores para su uso posterior.Copy these values for later use.

    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.For the embedded analytics sample app to work as expected, you have to create a workspace using the tool.

  2. (Opcional) En el Paso 4: importación de contenido, seleccione una de las opciones siguientes:(Optional) In Step 4 - Import content, select one of following options:

    • Si tiene su propia aplicación de Power BI, puede seleccionar Omitir.If you have your own Power BI app, you can select Skip.

    • 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.If you want to create a sample Power BI app using a sample report, select Sample Power BI report and then select Import.

    • 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.If you want to create a sample Power BI app using your own report, select Upload a .pbix file, browse for your file and then select Import.

  1. En el Paso 5: concesión de permisos, seleccione Conceder permisos y, en la ventana emergente, seleccione Aceptar.In Step 5 - Grant permissions, select Grant permissions and in the pop-up window select accept. 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.This allows your Azure AD app to access the APIs you selected (also known as scopes) with your signed in user. Este usuario también se conoce como usuario principal.This user is also known as the master user.

  2. (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).(Optional) If you created a Power BI workspace and uploaded content to it using the tool, you can now select Download sample application. Asegúrese de copiar toda la información en el cuadro Resumen.Make sure you copy all the information in the Summary Box.

Nota

Si ha omitido las fases opcionales, puede descargar igualmente una aplicación de Power BI de ejemplo,If you skipped the optional stages, you can still download a sample Power BI app. pero en el código de la aplicación descargada faltarán las propiedades que no haya rellenado durante el registro.However, the code in the downloaded app, will lack the properties that you didn't fill in during registration. Por ejemplo, si no ha creado un área de trabajo, la aplicación de ejemplo no incluirá el identificador del área de trabajo.For example, if you didn't create a workspace, the sample app will not include the workspace ID.

Cambio de los permisos de la aplicación de Azure ADChange your Azure AD app's permissions

Después de registrar la aplicación, puede realizar cambios en los permisos.After you register your application, you can make changes to its permissions. Los cambios en los permisos se pueden realizar mediante programación o en Azure Portal.Permission changes can be made programmatically, or in the Azure portal.

Nota

Los permisos de aplicación de Azure AD solo se aplican a estos escenarios:Azure AD app permissions are only applicable for these scenarios:

  • Insertar para la organizaciónEmbed for your organization
  • Insertar para los clientes con el método de autenticación de usuario maestroEmbed for your customers with the master user authentication method

En Azure Portal, puede ver la aplicación y realizar cambios en los permisos.In the Azure portal, you can view your app and make changes to its permissions.

  1. Inicie sesión en el Portal de Azure.Sign into the Azure portal.

  2. Elija el inquilino de Azure AD mediante la selección de la cuenta en la esquina superior derecha de la página.Select your Azure AD tenant by selecting your account in the upper right corner of the page.

  3. Seleccione App registrations (Registros de aplicaciones).Select App registrations. Si no puede ver esta opción, búsquela.If you can't see this option, search for it.

  4. En la pestaña Aplicaciones propias, seleccione la aplicación.From the Owned applications tab, select your app. La aplicación se abre en la pestaña Información general, donde puede revisar el valor Id. de la aplicación.The application opens in the Overview tab, where you can review the Application ID.

  5. Seleccione la pestaña Permisos de API.Select the API permissions tab.

  6. Para agregar permisos, siga estos pasos:To add permissions, follow these steps:

    1. Seleccione Agregar un permiso y, luego, Servicio Power BI.Select Add a permission and then select Power BI service.

    2. Seleccione Permisos delegados, y agregue o quite los permisos específicos que necesite.Select Delegated Permissions and add or remove the specific permissions you need.

    3. Cuando haya terminado, seleccione Agregar permisos para guardar los cambios.When you're done, select Add permissions to save your changes.

  7. Para quitar un permiso, siga estos pasos:To remove a permission, follow these steps:

    1. Seleccione los puntos suspensivos (…) situados a la derecha del permiso.Select the ellipsis (...) to the right of the permission.

    2. Seleccione Quitar permiso.Select Remove permission.

    3. En la ventana emergente Quitar permiso, seleccione Sí, quitar.In the Remove permission pop-up window, select Yes, remove.

Pasos siguientesNext steps

¿Tiene más preguntas?More questions? Pruebe a preguntar a la comunidad de Power BITry asking the Power BI Community