> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/automacao/runbooks/runbook-references/user/security/create-temporary-access-pass.md).

# 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 do utilizador

Este runbook envia um e-mail ao utilizador com o passo de acesso temporário. Para ativar isto, precisa de ativar a notificação do 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 obter mais informações sobre como personalizar runbooks, consulte o [Guia de Personalização do Runbook](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

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

O envio de um relatório por e-mail é opcional e só acontece quando é fornecido um destinatário (`EmailTo`) é fornecido. O endereço do remetente é obtido da `RJReport.EmailSender` definição do Tenant.

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

Consulte a [documentação das Configurações de Relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para mais detalhes.

### Localização

Utilizador → Segurança → Criar Temporary Access Pass

**Nome completo do runbook**

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

### Permissões

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

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

### Parâmetros

#### UserName

Nome principal do utilizador de destino.

| Propriedade  | Valor                |
| ------------ | -------------------- |
| Obrigatório  | verdadeiro           |
| Valor padrão |                      |
| Tipo         | Cadeia de caracteres |

#### LifetimeInMinutes

Duração do passe de acesso temporário em minutos. Os valores válidos estão entre 60 e 480 minutos (1-8 horas).

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

#### OneTimeUseOnly

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

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

#### NotifyUser

Se estiver 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 padrão | Falso    |
| Tipo         | Booleano |

#### 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 padrão |                      |
| Tipo         | Cadeia de caracteres |

#### ServiceDeskDisplayName

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

| Propriedade  | Valor                |
| ------------ | -------------------- |
| Obrigatório  | false                |
| Valor padrão |                      |
| Tipo         | Cadeia de caracteres |

#### ServiceDeskEmail

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

| Propriedade  | Valor                |
| ------------ | -------------------- |
| Obrigatório  | false                |
| Valor padrão |                      |
| Tipo         | Cadeia de caracteres |

#### ServiceDeskPhone

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

| Propriedade  | Valor                |
| ------------ | -------------------- |
| Obrigatório  | false                |
| Valor padrão |                      |
| Tipo         | Cadeia de caracteres |

[Voltar à visão geral da referência do runbook](/pt/automacao/runbooks/runbook-references.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
