> 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/org/applications/add-gsa-application-registration.md). # Adicionar Registo de Aplicação Gsa ### Descrição Este script cria um novo registro de aplicativo Global Secure Access em Azure Active Directory (Entra ID) com opções de configuração abrangentes. Além do aplicativo, é criado um Security Group para gerenciar o acesso ao aplicativo (o esquema de nomenclatura é configurável via Personalização do Runbook) e ele é atribuído ao Service Principal do aplicativo. Se o aplicativo já existir, o runbook é executado em modo de atualização: a criação do aplicativo é ignorada e apenas as etapas de segmento / grupo / atribuição são realizadas. Todas as consultas (por exemplo, grupo de conectores) são validadas ANTES de qualquer coisa ser criada. Se uma etapa posterior falhar mesmo assim, os objetos criados nesta execução (aplicativo, grupo) são revertidos e removidos. Objetos pré-existentes (modo de atualização) nunca são removidos. ### Localização Organização → Aplicativos → Adicionar Gsa Application Registration **Nome completo do runbook** rjgit-org\_applications\_add-gsa-application-registration ### Permissões #### Permissões da aplicação * **Tipo**: Microsoft Graph * Application.ReadWrite.All * Directory.ReadWrite.All * Group.ReadWrite.All * AppRoleAssignment.ReadWrite.All ### Parâmetros #### nome O nome base do aplicativo Global Secure Access a ser criado. O nome final do aplicativo é construído como " ". | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | true | | Valor predefinido | | | Tipo | String | #### prefixo Prefixo adicionado ao nome do aplicativo. Um espaço é inserido entre o prefixo e o nome, a menos que o prefixo termine com "-", "\_" ou um espaço. Exemplo: prefixo "GSA-" + nome "MyApp" resulta no aplicativo "GSA-MyApp". | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | true | | Valor predefinido | | | Tipo | String | #### groupPrefix Prefixo para o nome do Security Group. O nome do grupo é construído como "" - independentemente do prefixo do aplicativo. Exemplo: groupPrefix "App - Entra - GSA - " + name "MyApp" resulta no grupo "App - Entra - GSA - MyApp". Padrão: "App - Entra - GSA - ". | Propriedade | Valor | | ----------------- | ------------------- | | Obrigatório | false | | Valor predefinido | App - Entra - GSA - | | Tipo | String | #### groupSuffix Sufixo opcional para o nome do Security Group, por exemplo " (utilizadores)". Padrão: vazio. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | false | | Valor predefinido | | | Tipo | String | #### tipo de aplicativo O tipo de aplicativo GSA a criar. Opções: "nonwebapp" (Aplicativo Enterprise) ou "quickaccessapp" (Aplicativo de acesso rápido). | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | true | | Valor predefinido | | | Tipo | String | #### grupo de conectores O grupo de conectores a ser usado para o aplicativo. Deve ser definido na Personalização do Runbook. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | false | | Valor predefinido | | | Tipo | String | #### host de destino O host de destino ou intervalo de IP para o aplicativo. Suporta os formatos: FQDN (example.com), IP único (192.168.0.1), notação CIDR (192.168.0.1/24) ou intervalo de IP (192.168.0.1..192.168.0.20). | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | false | | Valor predefinido | | | Tipo | String | #### tipo de destino O tipo de destino especificado. Opções: "fqdn", "ip", "ipRangeCidr" ou "ipRange". Oculto na interface, pois é determinado automaticamente pelo formato de destinationHost. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | false | | Valor predefinido | | | Tipo | String | #### portas A(s) porta(s) a configurar para o aplicativo. Suporta porta única (443), várias portas (80,443) ou intervalo de portas (8000-8080). | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | false | | Valor predefinido | | | Tipo | String | #### protocolo O protocolo de rede a usar. Opções: "tcp", "udp" ou "tcp,udp". O padrão é "tcp". | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | false | | Valor predefinido | | | Tipo | String | [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/org/applications/add-gsa-application-registration.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.