Como usar atividades Microsoft 365 sem conexões do Integration Service

Sobre

Agora você pode usar as atividades mais recentes Microsoft 365 mesmo se não tiver o Integration Service, por meio do Microsoft 365 Scope.

As atividades Microsoft 365 projetadas especificamente para o Integration Service apresentam um campo Conexão, que permite que você escolha uma conexão criada por meio de um conector do Integration Service. Quando usadas dentro do Microsoft 365 Scope, as atividades simplesmente herdam as informações de conexão do Scope.

Matriz de tipos de projetos e autenticação

Microsoft 365
	Cloud		No local
	Escopo do aplicativo Microsoft Office 365	Integration Service	Escopo do aplicativo Microsoft Office 365	Integration Service
Multiplataforma
Token interativo - OAuth - Aplicativo público da UiPath
Token interativo - OAuth - BYOA
Autenticação do Windows Integrada
UsernameAndPassword
ID do Aplicativo e Segredo
IdDoAplicativo e Certificado
Windows
Token interativo - OAuth - Aplicativo público da UiPath
Token interativo - OAuth - BYOA
Autenticação do Windows Integrada
UsernameAndPassword
ID do Aplicativo e Segredo
IdDoAplicativo e Certificado

Métodos de conexão

Há duas maneiras de configurar uma conexão na atividade Microsoft 365 Scope .

Método de conexão		Description	Benefícios	Desvantagens
Ativo Observação: Recomendado.		Usa um Ativo do Orchestrator para armazenar a conexão com a configuração do Escopo. O ativo está no formato JSON. Sempre que é usada, a atividade recupera a configuração do ativo. Com base na configuração do ativo, o Scope se comporta de maneira diferente; ele identifica o tipo de autenticação e oculta campos desnecessários. Se o JSON do ativo não estiver definido corretamente, ele receberá um erro de validação.	As atividades se beneficiam das pesquisas de tempo de design e podem descobrir arquivos, pastas, listas, intervalos, entre outros. A conexão é facilmente transferível, pois as credenciais não são passadas de um usuário para outro em texto simples. Pode ser configurado por um Admin. É mais seguro, porque as credenciais não chegam no fluxo de trabalho do Studio.	Requer um usuário avançado para configurar o Ativo. Não é fácil configurá-lo para um Desenvolvedor Não Técnico.
Painel de Propriedades		Use o painel de propriedades existente para configurar as credenciais da conexão. A configuração pode ser adicionada em texto simples ou por meio de variáveis.	Mais fácil de usar. Mantém a compatibilidade com versões anteriores.
	Configuração por meio de texto simples Observação: Não é recomendado.	Configure o painel Propriedades com valores de texto simples.	As atividades se beneficiam das pesquisas de tempo de design e podem descobrir arquivos, pastas, listas, intervalos, entre outros.	Menos seguro, porque as credenciais precisam ser passadas entre usuários em texto simples.
	Configuração por meio de variáveis	Configure o painel de propriedades com variáveis.	Mais seguro, porque as credenciais não chegam ao fluxo de trabalho do Studio.	As atividades não podem descobrir quaisquer recursos no momento do design.

Formato de ativo do Microsoft 365 Scope

Observação: o uap usado nas seções a seguir representa o nome de usuário e a senha.

Formato padrão do ativo

O seguinte é o formato JSON aceito que você pode usar em ativos de texto, no tempo de design ou runtime, ou ambos, e ativos de credenciais que você pode usar no runtime para especificar detalhes do Microsoft 365.

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "",
        "TenantId": ""
    }
}

Observação: ao usar os parâmetros OAuth2AppData, ApplicationId e TenantId , certifique-se de preencher isso com base no modo de autenticação escolhido. Você pode encontrar exemplos nas seções a seguir.

A lista completa de opções que você pode escolher para os parâmetros Ambiente e Modo é:

• "Ambiente": "Padrão" | "Global" | "China" | "A Alemanha" | "US Government" | "US GovernmentOD",
• "Mode": "interativo" | "integrado" | "uap" | "appdsecret" | "appidcertificate",

Configuração de ativos do aplicativo UiPath (OAuth - aplicativo público da UiPath) com vários tenants

Observação: o ID do aplicativo no exemplo é o ID do aplicativo UiPath válido que você pode usar para conexões.

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "f2f43f65-16a6-4319-91b6-d2a342a88744",
        "TenantId": ""
    }
}

Quando um ID de tenant for necessário, verifique a seção Detalhes do token interativo .

Configuração de ativos do aplicativo UiPath de tenant único (OAuth — aplicativo público da UiPath)

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "f2f43f65-16a6-4319-91b6-d2a342a88744",
        "TenantId": "your unique Microsoft 365 tenant ID"
    }
}

Configuração de ativo de aplicativo personalizado de tenant único (OAuth - BYOA)

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "your unique Microsoft tenant ID",
        "TenantId": "your unique Microsoft 365 tenant ID"
    }
}

ID do aplicativo e configuração de ativos de aplicativo personalizado secreto (OAuth - BYOA)

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "your unique Microsoft 365 application secret",
    "Environment": "Default",
    "Mode": "appidsecret",
    "OAuth2AppData": {
        "ApplicationId": "your unique Microsoft tenant ID",
        "TenantId": "your unique Microsoft 365 tenant ID"
    }
}

Limitações

Os seguintes recursos não estão disponíveis ao usar atividades dentro do Microsoft 365 Scope: gatilhos, associações e experiência de substituição.

Atualização do token

Não há nenhum serviço disponível para atualizar seus tokens de conexão, como o que está disponível no Integration Service.

Se o token de autorização não for atualizado por um certo número de dias, ele expirará, e você deve autenticar novamente. Para evitar a expiração de tokens de autorização, execute um UiPath Robot com essa conexão específica. A execução de uma automação com a atividade Scope atualiza o token de autorização.

Recursos adicionais do OAuth 2.0:

• Com o fluxo de aprovação do administrador: fluxo de credenciais do cliente OAuth 2.0 na plataforma de identidade da Microsoft
• Sem fluxo de aprovação do administrador: plataforma de identidade da Microsoft e fluxo de código de autorização do OAuth 2.0 - plataforma de identidade da Microsoft