Conectar Power Apps a Fluid mediante OAuth 2.0

Este artículo explica cómo conectar una Microsoft Power App a la API de Fluid para que su aplicación pueda leer y escribir datos de Fluid en nombre del usuario que inició sesión, mediante el inicio de sesión seguro con OAuth 2.0 y Microsoft Entra ID (anteriormente Azure AD).

El conector personalizado que crea en esta guía se comparte en todo su entorno de Power Platform, por lo que la misma conexión también se puede usar en Power Automate. Si solo necesita Power Automate, consulte Configuración de Power Automate para llamar a la API de Fluid mediante OAuth 2.0.

---

Fluid publica una única aplicación "Fluid API" administrada por Fluid en el propio inquilino de Microsoft Entra de Fluid. Usted no registra la Fluid API por su cuenta, ni administra su URI de identificador de aplicación ni sus ámbitos. En su lugar:

1. Un administrador de Entra otorga un consentimiento de administrador único para que la Fluid API pueda emitir tokens en su inquilino.

2. Usted registra una pequeña aplicación cliente de conector propia, que inicia la sesión de los usuarios y solicita un token para la Fluid API (recurso api://{fluid-api-client-id}).

Su administrador de cuenta de Fluid le proporciona el ID de aplicación (cliente) de la Fluid API que necesitará.

---

Cuando alguien usa su Power App, Microsoft Entra ID le pide que inicie sesión con su cuenta laboral. Entra emite entonces un token de acceso seguro y Power Apps envía ese token a Fluid con cada solicitud. Fluid verifica el token e inicia la sesión del usuario con su cuenta de Fluid correspondiente – no se almacenan contraseñas ni claves de API en su aplicación.

Para que esto funcione, deben cumplirse tres condiciones:

1. La Fluid API tiene el consentimiento otorgado en su inquilino de Entra, y usted ha registrado una aplicación cliente de conector (Parte 1).

2. OAuth 2.0 está habilitado en su sitio de Fluid (una tarea del lado de Fluid).

3. Cada persona que usa la aplicación tiene una cuenta de Fluid cuyo nombre de usuario coincide con su correo electrónico laboral (UPN) y está activa.

---

Necesitará:

---

Estos pasos los realiza una sola vez un administrador de Microsoft Entra de su organización.

Un administrador de Microsoft Entra de su organización otorga el consentimiento único a la aplicación Fluid API. Usted genera el vínculo de consentimiento directamente desde su consola de administración de Fluid.

1. Inicie sesión en su instancia de Fluid como administrador de Fluid, haga clic en su foto de perfil en la esquina superior derecha y elija Admin Console > Proveedor de autenticación (o vaya a /Config/AuthenticationProvider).

2. Localice el campo Your Entra Tenant GUID e ingrese el ID de su inquilino de Microsoft Entra – un GUID con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Puede encontrarlo en el portal de Azure, en Microsoft Entra ID > Overview.

3. Una vez que haya ingresado el ID de su inquilino, el campo Fluid API Consent Url genera automáticamente el vínculo de consentimiento de administrador correcto para su inquilino.

4. Haga clic en el ícono de copiar junto al campo Fluid API Consent Url para copiar el vínculo en su portapapeles. Se verá similar a:

   https://login.microsoftonline.com/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/adminconsent?client_id=69c9b574-a5bf-46ca-bb04-ed5793d298e4&redirect_uri=https://www.fluid.work

5. Envíe el vínculo copiado a un administrador de Microsoft Entra de su organización (o ábralo usted mismo si tiene ese rol). El administrador abre el vínculo, inicia sesión y acepta el mensaje de permisos. Esto aprovisiona la Fluid API en su inquilino, de modo que aparezca en APIs my organization uses en el Paso 3.

Este es un paso de consentimiento, no un registro de aplicación. Usted está aprobando la aplicación publicada por Fluid — no la crea ni es su propietario. Sin este consentimiento, el inicio de sesión puede fallar con AADSTS650057 o "Need admin approval".

Esta es una pequeña aplicación propia con la que inicia sesión el conector (no es la Fluid API).

1. Inicie sesión en el centro de administración de Microsoft Entra como administrador.

2. Vaya a Identity > Applications > App registrations > + New registration.

3. Complete el formulario de registro:

   • Name: Fluid Connector

   • Supported account types: Accounts in this organizational directory only

   • Deje Redirect URI en blanco

4. Seleccione Register.

5. En la página Overview, copie el Application (client) ID y el Directory (tenant) ID.

En la aplicación Fluid Connector, seleccione API permissions y agregue dos permisos delegados:

a) Fluid API – access_as_user:

1. Seleccione + Add a permission > APIs my organization uses.

2. Busque la Fluid API (por nombre o por el ID de cliente de la Fluid API) y selecciónela.

3. Elija Delegated permissions, marque access_as_user y luego seleccione Add permissions.

b) Microsoft Graph – User.Read (los conectores de Power Apps requieren esto; sin él, el inicio de sesión falla con AADSTS90008):

1. Seleccione + Add a permission > Microsoft Graph > Delegated permissions.

2. Busque User.Read (Sign in and read user profile), márquelo y luego seleccione Add permissions.

Por último, seleccione Grant admin consent for [Your Organisation] y confirme — ambos permisos deben mostrar una marca verde.

La Fluid API solo aparece en APIs my organization uses después de que el Paso 1 (consentimiento del administrador) la haya aprovisionado en su inquilino. Fluid en sí no recibe ni usa datos de Microsoft Graph — User.Read lo usa Power Apps para completar el flujo de inicio de sesión.

El conector personalizado de Power Apps inicia sesión mediante un secreto de cliente (piense en él como la contraseña de la aplicación de conector).

1. En la aplicación Fluid Connector, seleccione Certificates & secrets > Client secrets > + New client secret.

2. Ingrese una descripción (por ejemplo, Power Platform connector) y elija una expiración acorde a la política de su organización.

3. Seleccione Add.

4. Copie de inmediato el Value del secreto (no el Secret ID). No podrá volver a verlo después de salir de la página.

Trate el secreto de cliente como una contraseña. Guárdelo de forma segura y configure un recordatorio para renovarlo antes de que expire — la conexión deja de funcionar cuando el secreto expira.

Entregue al creador de Power Apps los siguientes datos antes de pasar a la Parte 2:

Abra el Bloc de notas y pegue estos valores a medida que los recopila — los copiará directamente en Power Apps en la Parte 2.

---

Estos pasos los realiza el creador de Power Apps que va a compilar la aplicación.

Un conector personalizado es el puente entre Power Apps y la Fluid API.

1. Vaya a make.powerapps.com y confirme (en la esquina superior derecha) que está en el entorno correcto.

2. En el menú izquierdo, seleccione More > Discover all, y luego, en Data, abra Custom connectors.

3. Seleccione + New custom connector. Si aparece un menú desplegable, elija Create from blank; en los entornos más nuevos esto abre directamente el editor de conectores en blanco. (Evite las opciones de Import — esas requieren un archivo OpenAPI o Postman.)

4. Asígnele un nombre, por ejemplo Fluid, y seleccione Continue.

En la página General:

• Host: la dirección web de su Fluid sin https:// — por ejemplo, yourcompany.fluid.work

• Base URL: /

Seleccione Security para continuar.

En la página Security, complete los siguientes campos:

• Authentication type: OAuth 2.0

• Identity Provider: Azure Active Directory

• Client id: el Application (client) ID de la aplicación de conector (del Paso 2)

• Client secret: el valor del secreto de cliente del Paso 4

• Login URL: deje el valor predeterminado (normalmente https://login.windows.net)

• Tenant ID: el Directory (tenant) ID

• Resource URL: api://{fluid-api-client-id} — por ejemplo, api://00001111-aaaa-2222-bbbb-3333cccc4444

• Scope: api://{fluid-api-client-id}/access_as_user (si se deja en blanco, Power Apps solicita un ámbito predeterminado, que también funciona una vez que el conector está autorizado)

• Deje Enable on-behalf-of login desactivado (off)

Seleccione Create connector (arriba a la derecha) para guardar.

Dado que el Client ID del conector (su aplicación de conector) y el Resource (la Fluid API) son registros de aplicación distintos, use la Resource URL completa api://…. El problema anterior de AADSTS90009 "solicitar un token para sí mismo" no ocurre en este modelo.

Después de guardar el conector, Power Apps genera una Redirect URL que se muestra en la parte inferior de la página Security, normalmente:

https://global.consent.azure-apim.net/redirect

Regístrela en su aplicación cliente de conector:

1. Copie la Redirect URL de la página Security del conector.

2. En el centro de administración de Entra, abra su aplicación Fluid Connector > Authentication.

3. Seleccione + Add a platform > Web, pegue la Redirect URL y seleccione Configure. (Si ya existe una plataforma Web, agregue la URL a la lista existente de Redirect URIs.)

4. Seleccione Save.

Si el inicio de sesión falla más adelante con un mensaje sobre una reply URL o una discrepancia de redirect URI, casi siempre es este el paso que se omitió o se escribió mal.

El conector necesita al menos una operación definida antes de que la pestaña Test le permita ejecutar una llamada.

1. En el editor del conector, abra la pestaña Definition.

2. Seleccione + New action.

3. Asigne a la acción un Summary (p. ej. Get projects) y un Operation ID (p. ej. GetProjects).

4. En Request, seleccione + Import from sample:

   • Verb: GET

   • URL: un extremo de la Fluid API, por ejemplo https://yourcompany.fluid.work/api/data/v1/projects

   • Seleccione Import

5. Seleccione Update connector (arriba a la derecha) para guardar.

Para ver la lista completa de extremos de la Fluid API, consulte la documentación de la Fluid API o pregunte a su administrador de cuenta de Fluid. Para una prueba rápida de inicio de sesión, cualquier extremo GET válido que devuelva 200 confirma que OAuth está configurado correctamente.

1. De vuelta en el conector personalizado, abra la pestaña Test.

2. En Connections, seleccione + New connection.

3. Inicie sesión con su cuenta laboral y acepte el mensaje de permisos.

4. Una vez conectado, seleccione una operación y elija Test operation para confirmar que Fluid responde (HTTP 200).

1. Abra o cree una Canvas app en el editor de aplicaciones.

2. En el panel Data, seleccione + Add data; busque su conector Fluid y agréguelo.

3. Use las acciones del conector en su aplicación — por ejemplo, enlace una galería a una lista de Fluid, o invoque una acción desde el OnSelect de un botón.

Cada persona que usa la aplicación publicada inicia sesión con su propia cuenta laboral, por lo que solo ve y modifica los datos de Fluid que sus propios permisos de Fluid le permiten.

---

---

• Para el lado de Fluid (habilitar OAuth 2.0, el ID de cliente de la Fluid API, cuentas de usuario y permisos), comuníquese con su administrador del sistema de Fluid o con su administrador de cuenta de Fluid.

• Para el lado de Microsoft Entra (consentimiento del administrador, la aplicación de conector, los secretos), comuníquese con su administrador de Microsoft 365 / Azure.

• Excel y Power BI mediante OAuth 2.0

• Programar la actualización automática de Power BI desde Fluid con OAuth 2.0

• Acceso programático a la Fluid API mediante OAuth 2.0

• Configuración de Power Automate para llamar a la Fluid API mediante OAuth 2.0