Embed Token - Dashboards GenerateTokenInGroup
Genera un token de inserción para ver el panel especificado desde el área de trabajo especificada.
Importante
Esta llamada API solo es relevante para el escenario de inserción para los clientes . Para más información sobre el uso de esta API, consulte Consideraciones al generar un token de inserción.
- Al usar una entidad de servicio para la autenticación, consulte Inserción de contenido de Power BI con la entidad de servicio y consideraciones y limitaciones.
- Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: Perfiles de entidad de servicio en Power BI Embedded.
Todo lo siguiente:
- Dashboard.ReadWrite.All o Dashboard.Read.All
- Report.ReadWrite.All o Report.Read.All
- Dataset.ReadWrite.All o Dataset.Read.All
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dashboards/{dashboardId}/GenerateToken| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
dashboard
|
path | True |
string uuid |
El identificador del panel |
|
group
|
path | True |
string uuid |
Identificador del área de trabajo |
| Nombre | Tipo | Description |
|---|---|---|
| accessLevel |
Nivel de acceso necesario para la generación de tokens de inserción |
|
| allowSaveAs |
boolean |
Si un informe incrustado se puede guardar como un nuevo informe. El valor predeterminado es |
| datasetId |
string |
Identificador del conjunto de datos usado para la creación de informes. Solo se aplica cuando se genera un token de inserción para la creación de informes. |
| identities |
Lista de identidades que se van a usar para las reglas de seguridad de nivel de fila |
|
| lifetimeInMinutes |
integer |
Duración máxima del token en minutos, a partir del momento en que se generó. Se puede usar para acortar el tiempo de expiración de un token, pero no para ampliarlo. El valor debe ser un entero positivo. Cero (0) es equivalente a NULL y se omitirá, lo que dará lugar a la hora de expiración predeterminada. |
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
Aceptar |
| Generate a dashboard embed token using an effective identity with an identity blob example |
| Generate a dashboard embed token with multiple identities example |
Solicitud de ejemplo
POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dashboards/69ffaa6c-b36d-4d01-96f5-1ed67c64d4af/GenerateToken{
"accessLevel": "View",
"identities": [
{
"datasets": [
"cfafbeb1-8037-4d0c-896e-a46fb27ff229"
],
"identityBlob": {
"value": "eyJ0eX....AAA="
}
}
]
}Respuesta de muestra
{
"token": "H4sI....AAA=",
"tokenId": "49ae3742-54c0-4c29-af52-619ff93b5c80",
"expiration": "2018-07-29T17:58:19Z"
}Solicitud de ejemplo
POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dashboards/69ffaa6c-b36d-4d01-96f5-1ed67c64d4af/GenerateToken{
"accessLevel": "View",
"identities": [
{
"username": "john@contoso.com",
"roles": [
"sales"
],
"datasets": [
"cfafbeb1-8037-4d0c-896e-a46fb27ff229"
]
},
{
"username": "john_contoso",
"roles": [
"product"
],
"datasets": [
"a8b062ca-5730-468f-9df7-43c2ba76bf5e"
]
}
]
}Respuesta de muestra
{
"token": "H4sI....AAA=",
"tokenId": "49ae3742-54c0-4c29-af52-619ff93b5c80",
"expiration": "2018-07-29T17:58:19Z"
}| Nombre | Description |
|---|---|
|
Effective |
Define la identidad y los roles de usuario. Para obtener más información, consulte Seguridad de nivel de fila con Power BI Embedded. |
|
Embed |
Un token de inserción de Power BI |
|
Generate |
Solicitud de generación de tokens de Power BI |
|
Identity |
Un blob para especificar una identidad. Solo se admite para conjuntos de datos con una conexión directQuery a Azure SQL |
|
Token |
Nivel de acceso necesario para la generación de tokens de inserción |
Define la identidad y los roles de usuario. Para obtener más información, consulte Seguridad de nivel de fila con Power BI Embedded.
| Nombre | Tipo | Description |
|---|---|---|
| auditableContext |
string |
Contexto auditable EffectiveIdentity. Si se proporciona este parámetro y no está vacío, habilitará la auditoría de EffectiveIdentity y su valor se establecerá en el nombre de usuario en el registro de auditoría. De lo contrario, se omitirá el contexto EffectiveIdentity del registro de auditoría GenerateToken. |
| customData |
string |
Datos personalizados que se usan para aplicar reglas de seguridad de nivel de fila. Solo se admite para la conexión dinámica a modelos de Azure Analysis Services y modelos en la nube. |
| datasets |
string[] |
Matriz de conjuntos de datos para los que se aplica esta identidad |
| identityBlob |
Un blob que especifica una identidad. Solo se admite para conjuntos de datos con una conexión directQuery a Azure SQL. |
|
| reports |
string[] |
Matriz de informes para los que se aplica esta identidad. Solo se admite para informes paginados. |
| roles |
string[] |
Matriz de roles de seguridad de nivel de fila (RLS) dentro de un token que aplica reglas de RLS. Una identidad puede contener hasta 50 roles. Un rol puede contener cualquier carácter excepto |
| username |
string |
Nombre de usuario efectivo dentro de un token que aplica reglas de seguridad de nivel de fila. Para un modelo local, el nombre de usuario puede contener caracteres alfanuméricos o cualquiera de los caracteres |
Un token de inserción de Power BI
| Nombre | Tipo | Description |
|---|---|---|
| expiration |
string |
Fecha y hora (UTC) de expiración del token |
| token |
string |
Token de inserción |
| tokenId |
string |
Identificador de token único. A través de los registros de auditoría, el identificador del token se puede usar para correlacionar las operaciones que usan el token con la operación de generación. |
Solicitud de generación de tokens de Power BI
| Nombre | Tipo | Description |
|---|---|---|
| accessLevel |
Nivel de acceso necesario para la generación de tokens de inserción |
|
| allowSaveAs |
boolean |
Si un informe incrustado se puede guardar como un nuevo informe. El valor predeterminado es |
| datasetId |
string |
Identificador del conjunto de datos usado para la creación de informes. Solo se aplica cuando se genera un token de inserción para la creación de informes. |
| identities |
Lista de identidades que se van a usar para las reglas de seguridad de nivel de fila |
|
| lifetimeInMinutes |
integer |
Duración máxima del token en minutos, a partir del momento en que se generó. Se puede usar para acortar el tiempo de expiración de un token, pero no para ampliarlo. El valor debe ser un entero positivo. Cero (0) es equivalente a NULL y se omitirá, lo que dará lugar a la hora de expiración predeterminada. |
Un blob para especificar una identidad. Solo se admite para conjuntos de datos con una conexión directQuery a Azure SQL
| Nombre | Tipo | Description |
|---|---|---|
| value |
string |
Un token de acceso de OAuth 2.0 para Azure SQL |
Nivel de acceso necesario para la generación de tokens de inserción
| Valor | Description |
|---|---|
| Create |
Indica que el token de inserción generado concede permiso de creación. Solo se aplica cuando se genera un token de inserción para la creación de informes. |
| Edit |
Indica que el token de inserción generado concede permisos de vista y edición. Solo se aplica cuando se genera un token de inserción para la inserción de informes. |
| View |
Indica que el token de inserción generado concede permiso de solo vista. |