> 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/automatizacao/runbooks/runbook-references/user/security/create-temporary-access-pass.md). # Criar Temporary Access Pass Criar um Temporary Access Pass para este utilizador ### Descrição Cria um Temporary Access Pass (TAP) para este utilizador, para que possa iniciar sessão e configurar os seus métodos de autenticação sem uma palavra-passe. Qualquer passe existente é removido primeiro e o novo passe é mostrado na saída do runbook. Opcionalmente, o utilizador recebe um e-mail com o passe, em alemão para o local de utilização DE e, caso contrário, em inglês. ### Ativar notificação do utilizador Este runbook envia um e-mail ao utilizador com o Temporary Access Pass. 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 }, "ServiceDeskPortalUrl": { "Hide": true }, "ServiceDeskTicketUrl": { "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 emails Enviar um relatório por email é opcional e só acontece quando é fornecido um destinatário (`EmailTo`). O endereço do remetente é obtido da definição do `RJReport.EmailSender` Tenant. Este runbook envia emails utilizando a API do Microsoft Graph. Para enviar emails através da Graph API, é necessário configurar um endereço de email existente na personalização do runbook. Consulte a [documentação das definições de relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obter detalhes sobre todas as definições disponíveis. #### Branding do email O email do relatório respeita as definições opcionais de `RJReport.Branding.*` do Tenant: * **Imagem do cabeçalho e do rodapé** – URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada * **Ligação no rodapé** – destino da imagem do rodapé * **Cor de destaque e do texto** – valores hexadecimais de 6 dígitos, por exemplo `#0052cc` Quando estas definições não estão configuradas, são utilizadas as imagens e cores predefinidas do RealmJoin. Uma imagem que não possa ser transferida ou validada, ou um valor de cor inválido, nunca impede o email do relatório – é utilizada em vez disso a predefinição correspondente. Instruções de configuração e requisitos da imagem: [Branding do email](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional). ### Localização Utilizador → Segurança → Criar Temporary Access Pass **Nome completo do Runbook** rjgit-user\_security\_create-temporary-access-pass ### Detalhes | Propriedade | Valor | | ------------------- | ----------------------------------- | | Versão | 1.4.0 | | Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.10) | | Agendável | não | ### Permissões #### Permissões da aplicação * **Tipo**: Microsoft Graph * UserAuthenticationMethod.ReadWrite.All * *Elimina os Temporary Access Passes existentes e cria o novo* * User.Read.All * *Lê o e-mail e o local de utilização do utilizador através de /users/{UPN} para saída e notificação* * Mail.Send *(opcional — funcionalidade: notificação por e-mail)* * *Envia por e-mail o novo Temporary Access Pass ao utilizador quando NotifyUser está ativado* ### Parâmetros #### Nome de utilizador Nome principal do utilizador sobre o qual o runbook atua. Definido pelo portal a partir do utilizador selecionado. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | verdadeiro | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### LifetimeInMinutes Durante quanto tempo o passe permanece válido, entre 60 e 480 minutos. | Propriedade | Valor | | ----------------- | ----- | | Obrigatório | falso | | Valor predefinido | 240 | | Tipo | Int32 | #### OneTimeUseOnly Um passe de utilização única funciona para um único início de sessão; caso contrário, pode ser reutilizado até expirar. | Propriedade | Valor | | ----------------- | ---------- | | Obrigatório | falso | | Valor predefinido | Verdadeiro | | Tipo | Booleano | #### NotifyUser Se o utilizador recebe por e-mail o novo passe. Predefinido na personalização do runbook. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### EmailFrom Endereço do remetente do e-mail de notificação. Obtido a partir da definição do Tenant RJReport.EmailSender. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingHeaderImageUrl Imagem de cabeçalho do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.HeaderImageUrl; é utilizado o cabeçalho predefinido do RealmJoin quando estiver vazio. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingFooterImageUrl Imagem de rodapé do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.FooterImageUrl; é utilizado o rodapé predefinido do RealmJoin quando estiver vazio. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingFooterLink Ligação por trás da imagem de rodapé do email do relatório. Obtida da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é utilizado quando estiver vazio. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingAccentColor Cor de destaque do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.AccentColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingTextColor Cor do texto do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.TextColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskDisplayName Nome do service desk mostrado no e-mail. Obtido a partir da definição do Tenant RJReport.ServiceDesk\_DisplayName. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskEmail Endereço de e-mail do service desk mostrado no e-mail. Obtido a partir da definição do Tenant RJReport.ServiceDesk\_EMail. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskPhone Número de telefone do service desk mostrado no e-mail. Obtido a partir da definição do Tenant RJReport.ServiceDesk\_Phone. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskPortalUrl Ligação para o portal do service desk mostrada no e-mail. Obtida a partir da definição do Tenant RJReport.ServiceDesk\_PortalUrl. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskTicketUrl Ligação para o ticket deste pedido, mostrada no e-mail. Predefinida por execução ou na personalização do runbook; vazio significa sem ligação. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | [Voltar à visão geral da referência do Runbook](/pt/automatizacao/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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.realmjoin.com/pt/automatizacao/runbooks/runbook-references/user/security/create-temporary-access-pass.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.