Criar conexão com uma entidade de serviço

Artigo
09/21/2023

Para criar uma conexão com uma entidade de serviço, a melhor abordagem é registrar o computador usando uma entidade de serviço com registro silencioso. Como alternativa, você pode conceder permissões à entidade de serviço no computador ou no grupo de computador e, em seguida, criar uma conexão usando a entidade de serviço.

Conceda permissões no computador ou no grupo de computadores

Para conceder permissões no computador:

Entre no Power Automate e selecione Computadores no painel de navegação à esquerda. Se o item não estiver no painel de navegação esquerdo, selecione …More e selecione o item desejado.
Selecione o computador ou grupo de computadores que deseja compartilhar.
Selecione Compartilhar e procure e selecione a instância AAD do Usuário do Aplicativo em sua instância do Dataverse.
Selecione Usuário e, em seguida, selecione Salvar.

Criar a conexão usando uma entidade de serviço

Depois de compartilhar o computador com o usuário do aplicativo, crie a conexão. Você precisa criar a conexão como a entidade de serviço. A criação de uma conexão como entidade de serviço não é compatível com o portal da Web do Power Automate. Atualmente, isso só é compatível com uma chamada direta à API Web.

Solicitar um token de acesso

Primeiro, solicite um token de acesso para interagir com a API do Power Platform. Mais informações: Solicite um token de acesso.

Obtenha o ID do grupo de computadores ou grupo

Para poder criar a conexão, obtenha o ID do grupo associado ao computador ou o grupo de computadores.

Se for um grupo, você pode acessar Monitor>Computadores>Grupos de computadores e selecionar o grupo. Você pode obter a ID do grupo do URL.
Se for um computador, acesse Dados>Tabelas>Todos>Grupo de Computadores do Fluxo. Procure seu computador na lista e exiba a coluna Grupo de Computadores do Fluxo, é a ID do grupo associado ao seu computador.

Criar uma conexão usando sua entidade de serviço

Para criar uma conexão, envie um HTTP PUT à API do Power Apps para criar a conexão, usando o token de acesso obtido anteriormente.

PUT https://{ENVIRONMENT_ID_URL}.environment.api.powerplatform.com/connectivity/connectors/shared_uiflow/connections/{CONNECTION_ID}?api-version=1
Content-Type: application/json
Host: {ENVIRONMENT_ID_URL}.environment.api.powerplatform.com
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJu...
BODY:
{
    "properties":
    {
        "environment":
        {
            "id": "/providers/Microsoft.PowerApps/environments/{ENVIRONMENT_ID}",
            "name":"{ENVIRONMENT_ID}"
        },
        "connectionParametersSet":
        {
            "name":"azureRelay",
            "values":
            {
                "username":{"value":"{MACHINE_ACCOUNT}"},
                "password":{"value":"{MACHINE_PASSWORD}"},
                "targetId":{"value":"{GROUP_ID}"}
            }
        }
    }
}

O exemplo acima contém espaços reservados:

ENVIRONMENT_ID_URL: o ID do ambiente, com todos os separadores removidos e os dois últimos caracteres separados por um ponto. (Exemplo: 37520647-dbdf-49fa-ba01-6134c14680c4 -> 37520647dbdf49faba016134c14680.c4).
ENVIRONMENT_ID: A ID do ambiente.
CONNECTION_ID: a ID de conexão usada para criar a conexão. Ele precisa ser uma GUID válida. (Você pode usar o comando New-Guid PowerShell para obter isso).
MACHINE_ACCOUNT: o nome de usuário da conta usada para abrir uma sessão do Windows.
MACHINE_PASSWORD: A senha da conta.
GROUP_ID: A ID do grupo que você deseja atualizar. Mais informações: Obtenha a ID do grupo de computadores ou grupo

Assim que a solicitação for concluída, salve a ID de conexão que você usou na solicitação. Você o usará na próxima etapa para Preencher as referências de conexão para implantação automatizada.

Próximas etapas

Preencher as referências de conexão para implantação automatizada

Compartilhar via