# Criar Temporary Access Pass

### Descrição

Cria um novo método de autenticação Temporary Access Pass (TAP) para um utilizador no Microsoft Entra ID. Os TAPs existentes para o utilizador são removidos antes de criar um novo. Opcionalmente, envia um e-mail de notificação para o endereço de e-mail principal do utilizador, informando-o sobre o TAP recém-criado. O idioma do e-mail é determinado automaticamente pela localização de utilização do utilizador.

### Ativar notificação ao utilizador

Este runbook envia um e-mail ao utilizador com o Temporary Access Pass. Para ativar isto, é necessário ativar a notificação ao utilizador na personalização do runbook.

A configuração JSON para isto é a seguinte:

```json
"rjgit-user_security_create-temporary-access-pass": {
    "parameters": {
        "UserName": {
            "Hide": true
        },
        "NotifyUser": {
            "Default": true,
            "Hide": true
        },
        "EmailFrom": {
            "Hide": true
        },
        "ServiceDeskDisplayName": {
            "Hide": true
        },
        "ServiceDeskEmail": {
            "Hide": true
        },
        "ServiceDeskPhone": {
            "Hide": true
        },
        "CallerName": {
            "Hide": true
        }
    }
}
```

Para mais informações sobre como personalizar runbooks, consulte o [Guia de Personalização de Runbooks](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### Configuração relativa ao envio de e-mails

Este runbook envia e-mails usando a API do Microsoft Graph. Para enviar e-mails via Graph API, é necessário configurar um endereço de e-mail existente na personalização do runbook.

Este processo é descrito em detalhe na [Configuração de Relatórios por E-mail](https://github.com/realmjoin/realmjoin-runbooks/tree/master/docs/general/setup-email-reporting.md) documentação.

### Localização

User → Security → Create Temporary Access Pass

**Nome completo do Runbook**

rjgit-user\_security\_create-temporary-access-pass

### Permissões

#### Permissões da aplicação

* **Tipo**: Microsoft Graph
  * UserAuthenticationMethod.ReadWrite.All

### Parâmetros

#### UserName

Nome principal do utilizador do utilizador de destino.

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | true   |
| Valor predefinido |        |
| Tipo              | String |

#### LifetimeInMinutes

Duração do Temporary Access Pass em minutos. Os valores válidos estão entre 60 e 480 minutos (1-8 horas).

| Propriedade       | Valor |
| ----------------- | ----- |
| Obrigatório       | false |
| Valor predefinido | 240   |
| Tipo              | Int32 |

#### OneTimeUseOnly

Se definido como true, o passe só pode ser usado uma vez.

| Propriedade       | Valor   |
| ----------------- | ------- |
| Obrigatório       | false   |
| Valor predefinido | True    |
| Tipo              | Boolean |

#### NotifyUser

Se ativado, envia um e-mail de notificação para o endereço de e-mail principal do utilizador sobre o TAP recém-criado.

| Propriedade       | Valor   |
| ----------------- | ------- |
| Obrigatório       | false   |
| Valor predefinido | False   |
| Tipo              | Boolean |

#### EmailFrom

O endereço de e-mail do remetente. Isto precisa de ser configurado na personalização do runbook.

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | false  |
| Valor predefinido |        |
| Tipo              | String |

#### ServiceDeskDisplayName

Nome de apresentação do Service Desk para informações de contacto do utilizador (opcional).

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | false  |
| Valor predefinido |        |
| Tipo              | String |

#### ServiceDeskEmail

Endereço de e-mail do Service Desk para informações de contacto do utilizador (opcional).

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | false  |
| Valor predefinido |        |
| Tipo              | String |

#### ServiceDeskPhone

Número de telefone do Service Desk para informações de contacto do utilizador (opcional).

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | false  |
| Valor predefinido |        |
| Tipo              | String |

[Voltar para a visão geral da referência de Runbooks](https://docs.realmjoin.com/pt/automacao/runbooks/runbook-references)