# Criar Temporary Access Pass

### Descrição

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

### Ativar notificação ao usuário

Este runbook envia um email ao usuário com o temporary access pass. Para habilitar isso, você precisa ativar a notificação ao usuário na personalização do runbook.

A configuração json para isso é 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 Runbook](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### Configuração relacionada ao envio de e-mail

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

Esse processo é descrito em detalhes 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

Usuário → Segurança → Criar Temporary Access Pass

**Nome completo do Runbook**

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

### Permissões

#### Permissões de aplicativo

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

### Parâmetros

#### UserName

Nome principal de utilizador do utilizador de destino.

| Propriedade  | Valor  |
| ------------ | ------ |
| Obrigatório  | true   |
| Valor padrão |        |
| Tipo         | String |

#### TempoDeVidaEmMinutos

Tempo de vida do temporary access pass em minutos. Os valores válidos estão entre 60 e 480 minutos (1 a 8 horas).

| Propriedade  | Valor |
| ------------ | ----- |
| Obrigatório  | false |
| Valor padrão | 240   |
| Tipo         | Int32 |

#### ApenasUsoÚnico

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

| Propriedade  | Valor   |
| ------------ | ------- |
| Obrigatório  | false   |
| Valor padrão | True    |
| Tipo         | Boolean |

#### NotifyUser

Se habilitado, envia um email de notificação para o endereço de email principal do usuário sobre o TAP recém-criado.

| Propriedade  | Valor   |
| ------------ | ------- |
| Obrigatório  | false   |
| Valor padrão | False   |
| Tipo         | Boolean |

#### EmailFrom

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

| Propriedade  | Valor  |
| ------------ | ------ |
| Obrigatório  | false  |
| Valor padrão |        |
| Tipo         | String |

#### ServiceDeskDisplayName

Nome de exibição do Service Desk para informações de contato do usuário (opcional).

| Propriedade  | Valor  |
| ------------ | ------ |
| Obrigatório  | false  |
| Valor padrão |        |
| Tipo         | String |

#### ServiceDeskEmail

Endereço de email do Service Desk para informações de contato do usuário (opcional).

| Propriedade  | Valor  |
| ------------ | ------ |
| Obrigatório  | false  |
| Valor padrão |        |
| Tipo         | String |

#### ServiceDeskPhone

Número de telefone do Service Desk para informações de contato do usuário (opcional).

| Propriedade  | Valor  |
| ------------ | ------ |
| Obrigatório  | false  |
| Valor padrão |        |
| Tipo         | String |

[Voltar para a visão geral da Referência de Runbook](/pt/automacao/runbooks/runbook-references.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.realmjoin.com/pt/automacao/runbooks/runbook-references/user/security/create-temporary-access-pass.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.