

# Configuração de conexões do Monday
<a name="monday-configuring-connections"></a>

O Monday oferece suporte aos dois tipos seguintes de mecanismo de autenticação:

1.  Autenticação OAuth: o Monday oferece suporte ao tipo de concessão AUTHORIZATION\$1CODE para OAuth2. 
   +  Esse tipo de concessão é considerado um OAuth de “três pernas”, pois conta com o redirecionamento dos usuários para o servidor de autorização de terceiros para autenticar o usuário. Ele é usado na criação de conexões por meio do Console do AWS Glue. O usuário que está criando uma conexão pode, por padrão, contar com uma aplicação conectada pertencente ao AWS Glue, na qual ele não precisa fornecer quaisquer informações relacionadas ao OAuth, exceto o instanceurl do Monday. O Console do AWS Glue redirecionará o usuário para o Monday, onde ele deverá fazer login e dar autorização para que as permissões solicitadas pelo AWS Glue acessem a instância do Monday. 
   +  Os usuários devem optar por criar sua própria aplicação conectada no Monday e fornecer seus próprios ID e segredo do cliente ao criar conexões por meio do Console do AWS Glue. Nesse cenário, eles ainda serão redirecionados para o Monday para fazer login e autorizar o acesso do AWS Glue aos recursos. 
   +  Esse tipo de concessão resulta em um token de atualização e um token de acesso. O token de acesso ficará ativo por uma hora e poderá ser atualizado automaticamente sem a interação do usuário por meio do token de atualização. 
   +  Para obter mais informações, consulte a [documentação sobre como criar uma aplicação conectada para o fluxo AUTHORIZATION\$1CODE do OAuth](https://developers.Monday.com/docs/api/v1/Oauth). 

1.  Autenticação personalizada: 
   +  Para obter a documentação pública do Monday sobre como gerar as chaves de API necessárias para a autorização personalizada, consulte [https://developer.monday.com/api-reference/docs/authentication\$1api-token-permissions](https://developer.monday.com/api-reference/docs/authentication#api-token-permissions). 

Para configurar uma conexão do Monday:

1.  No AWS Secrets Manager, crie um segredo com os detalhes a seguir. É necessário criar um segredo para cada conexão no AWS Glue. 

   1.  Para a autenticação OAuth: 
      +  Para uma aplicação conectada gerenciada pelo cliente, o segredo deve conter o segredo do consumidor da aplicação conectada com a chave USER\$1MANAGED\$1CLIENT\$1APPLICATION\$1CLIENT\$1SECRET. 

   1.  Para a autenticação personalizada: 
      +  Para uma aplicação conectada gerenciada pelo cliente, o segredo deve conter o segredo do consumidor da aplicação conectada com a chave `personalAccessToken`. 

1. Em AWS Glue Studio, crie uma conexão em **Conexões de dados** seguindo estas etapas: 

   1.  Em Conexões de dados, escolha **Criar conexão**. 

   1. Ao selecionar uma **Fonte de dados**, selecione o Monday.

   1. Forneça o **instanceURL** do Monday.

   1.  Selecione o perfil do IAM que o AWS Glue pode assumir e tem permissões para as seguintes ações: 

------
#### [ JSON ]

****  

      ```
      {
        "Version":"2012-10-17",		 	 	 
        "Statement": [
          {
            "Effect": "Allow",
            "Action": [
              "secretsmanager:DescribeSecret",
              "secretsmanager:GetSecretValue",
              "secretsmanager:PutSecretValue",
              "ec2:CreateNetworkInterface",
              "ec2:DescribeNetworkInterfaces",
              "ec2:DeleteNetworkInterface"
            ],
            "Resource": "*"
          }
        ]
      }
      ```

------

   1.  Selecione o tipo de autenticação para se conectar ao Monday 
      +  Para a autenticação OAuth: forneça o **URL do Token** e o **ClientId da aplicação cliente gerenciada pelo usuário** do Monday ao qual deseja se conectar. 
      +  Para a autenticação personalizada: selecione o tipo de autenticação **PERSONALIZADA** para se conectar ao Monday. 

   1.  Selecione o `secretName` que você deseja usar para essa conexão no AWS Glue para colocar os tokens. 

   1.  Selecione as opções de rede se quiser usar sua rede. 

1.  Conceda permissão ao perfil do IAM associado ao seu trabalho do AWS Glue para ler `secretName`. Escolha **Próximo**. 

1.  Na configuração do trabalho do AWS Glue, forneça `connectionName` como uma **Conexão de rede adicional**. 