> 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 um utilizador ### 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 email de notificação para o endereço de email principal do utilizador, informando-o sobre o TAP recém-criado. O idioma do email é determinado automaticamente pela localização de utilização do utilizador. ### Ativar notificação ao utilizador Este runbook envia um email 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 e-mails O envio de um relatório por e-mail é opcional e só acontece quando um destinatário (`EmailTo`) é fornecido. O endereço do remetente é obtido da `RJReport.EmailSender` configuração do Tenant. Este Runbook envia e-mails usando a API do Microsoft Graph. Para enviar e-mails através da API do Microsoft Graph, é necessário configurar um endereço de e-mail existente na personalização do runbook. Consulte a [documentação de Configurações de Relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para detalhes sobre todas as definições disponíveis. #### Branding do e-mail O e-mail do relatório respeita a configuração opcional `RJReport.Branding.*` do Tenant: * **Imagem de cabeçalho e rodapé** – URLs públicas HTTPS, PNG/JPEG/GIF, máx. 200 KB cada * **Ligação do rodapé** – destino da imagem de rodapé * **Cor de acento e texto** – valores hexadecimais de 6 dígitos, por exemplo `#0052cc` Quando estas definições não estão configuradas, são usados os gráficos e cores padrão do RealmJoin. Uma imagem que não possa ser descarregada ou validada, ou um valor de cor inválido, nunca impede o e-mail do relatório – em vez disso, é usado o padrão correspondente. Instruções de configuração e requisitos de imagem: [Branding do e-mail](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.9) | | 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 email e a localização 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 email o novo Temporary Access Pass ao utilizador quando NotifyUser está ativado* ### Parâmetros #### UserName Nome principal do utilizador-alvo. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | verdadeiro | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### 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 | falso | | Valor predefinido | 240 | | Tipo | Int32 | #### OneTimeUseOnly Se definido como verdadeiro, o passe pode ser usado apenas uma vez. | Propriedade | Valor | | ----------------- | ---------- | | Obrigatório | falso | | Valor predefinido | Verdadeiro | | Tipo | Booleano | #### NotifyUser Se ativado, envia um email de notificação para o endereço de email principal do utilizador sobre o TAP recém-criado. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### EmailFrom O endereço de e-mail do remetente. Isto precisa de ser configurado na personalização do runbook. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingHeaderImageUrl URL HTTPS pública opcional de uma imagem de cabeçalho personalizada (PNG/JPEG/GIF, máx. 200 KB) para o e-mail do relatório. Obtida da configuração do Tenant RJReport.Branding.HeaderImageUrl. Quando vazio, é usada a imagem de cabeçalho padrão do RealmJoin. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingFooterImageUrl URL HTTPS pública opcional de uma imagem de rodapé personalizada (PNG/JPEG/GIF, máx. 200 KB) para o e-mail do relatório. Obtida da configuração do Tenant RJReport.Branding.FooterImageUrl. Quando vazio, é usada a imagem de rodapé padrão do RealmJoin. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingFooterLink URL opcional para a qual a imagem de rodapé aponta. Obtida da configuração do Tenant RJReport.Branding.FooterLink. Quando vazio, é usada a ligação padrão (). | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingAccentColor Substituição opcional da cor de acento (hex de 6 dígitos, por exemplo '#0052cc') para o modelo de e-mail do relatório. Obtida da configuração do Tenant RJReport.Branding.AccentColor. Quando vazio ou inválido, é usada a cor de acento padrão do RealmJoin. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingTextColor Substituição opcional da cor do texto (hex de 6 dígitos) para o modelo de e-mail do relatório. Obtida da configuração do Tenant RJReport.Branding.TextColor. Quando vazio ou inválido, é usada a cor de texto padrão do RealmJoin. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskDisplayName Nome a apresentar do Service Desk para informações de contacto do utilizador (opcional). | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskEmail Endereço de email do Service Desk para informações de contacto do utilizador (opcional). | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskPhone Número de telefone do Service Desk para informações de contacto do utilizador (opcional). | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskPortalUrl URL do portal do Service Desk para informações de contacto do utilizador, apresentada como uma ligação clicável (opcional). | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskTicketUrl Ligação direta para o ticket do Service Desk relacionado com este pedido, apresentada como uma ligação clicável (opcional). Vazia por predefinição, por isso não é adicionada nenhuma ligação para o ticket. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | 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 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/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 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.