> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/o-seu-espaco-de-trabalho/team/rippling-sso.md).

# Configuração de SSO da Rippling

Configure o início de sessão único SAML da Rippling para o seu espaço de trabalho AirOps, mapeie atributos dos funcionários e teste o início de sessão a partir da AirOps e da Rippling.

Ligue o Rippling ao seu espaço de trabalho AirOps para que os colaboradores possam iniciar sessão com a respetiva conta Rippling. Um administrador configura a ligação uma vez e, depois, atribui a app AirOps aos colaboradores no Rippling.

A configuração troca dois conjuntos de valores: o AirOps fornece os URLs de destino e o Rippling fornece os metadados do fornecedor de identidade.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-807c59ee1a49bf7780e4ef92a4d971913c5ecb3b%2Frippling-sso-00-overview.png?alt=media" alt="Copy the ACS URL and SP entity ID from AirOps to Rippling, then import Rippling IdP metadata XML into AirOps"><figcaption><p>Mantenha ambas as páginas de administrador abertas. Irá copiar valores em ambas as direções.</p></figcaption></figure>

## Antes de começar

Você precisa de:

* Um espaço de trabalho AirOps com SSO do Rippling ativado e permissão para gerir as definições de SSO. Contacte a equipa da sua conta AirOps se o Rippling não aparecer na lista de fornecedores.
* Permissão para criar e configurar uma aplicação SAML personalizada na sua empresa Rippling.
* Um colaborador que possa atribuir para testes, com um e-mail profissional e primeiro nome no Rippling.

Mantenha a sua sessão atual de administrador do AirOps aberta enquanto testa num perfil de navegador separado ou numa janela privada.

## Como Configurar

Siga estes passos pela ordem indicada. Mantenha o AirOps e o Rippling abertos em separadores separados para poder trocar os detalhes da ligação antes de testar o início de sessão. Cada captura de ecrã anotada de onboarding inclui chamadas numeradas para os controlos a utilizar. Clique numa imagem para a ampliar.

### 1. Copie os detalhes da ligação do AirOps

No seu **AirOps** separador:

1. Abrir **Definições → Início de sessão único**.
2. Encontre **Rippling** e clique em **Configurar**.
3. Copie o **URL ACS** quanto no **ID de entidade do SP**. Mantenha este formulário aberto; voltará a ele no passo 8.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-5966527e78da4fd419065326b0e64f32be85e3fc%2Fsso-rippling-01-connection.png?alt=media" alt="Add Rippling SAML connection dialog with the ACS URL and SP entity ID and their copy buttons"><figcaption><p>Copie ambos os valores do seu próprio espaço de trabalho.</p></figcaption></figure>

### 2. Inicie uma integração personalizada no Rippling

Mude para **Rippling**:

1. Abrir **TI → Acesso de terceiros**.
2. Clique em **Adicionar integração**.
3. Selecione **Criar nova integração personalizada**.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-671cecbb4b87af80cf2de7c97963c58b8476322d%2Frippling-sso-02-add-integration.jpg?alt=media" alt="Rippling Add integration menu with Create new custom integration"><figcaption><p>Abra o formulário de criação da integração personalizada.</p></figcaption></figure>

### 3. Introduza o nome da app, a categoria e o logótipo

Em **Criar nova integração**, preencha:

| Campo                     | O que introduzir                                                                  |
| ------------------------- | --------------------------------------------------------------------------------- |
| **Nome**                  | Um nome reconhecível, como `AirOps SSO`.                                          |
| **Selecionar categorias** | Escolha uma categoria, como **Produtividade**.                                    |
| **Carregar logótipo**     | Carregue o logótipo que pretende que os colaboradores vejam no mosaico do AirOps. |

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-2805edfe525c635b5fa076a3d473b83eb8e383d2%2Frippling-sso-app-details-full.svg?alt=media" alt="Rippling Create new integration form showing the app Name, Productivity category, and an uploaded logo"><figcaption><p>A app de exemplo chama-se AirOps SSO. Escolha um nome que os colaboradores reconheçam.</p></figcaption></figure>

Permaneça nesta página e desça até **Tipo de integração personalizada**.

### 4. Selecione início de sessão único SAML

Na parte inferior do mesmo formulário:

1. Selecione **Integração de acesso do utilizador**.
2. Em **Funcionalidades**, marque **Início de sessão único**.
3. Escolha **SAML** na lista pendente que aparece.
4. Deixe **Aprovisionamento e desprovisionamento de contas via SCIM** desmarcado.
5. Ative **Suporta aprovisionamento just-in-time** se os colaboradores devem receber uma conta AirOps no primeiro início de sessão bem-sucedido. As restrições de registo do AirOps continuam a aplicar-se.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-310ae5bc1a46256990da53bf9d08fe0ce787b71a%2Frippling-sso-app-saml-full.svg?alt=media" alt="Rippling form with User access integration selected, Single sign-on checked, SAML selected, SCIM unchecked, and just-in-time provisioning enabled"><figcaption><p>Selecione a capacidade SAML e o comportamento de aprovisionamento para a sua implementação.</p></figcaption></figure>

Clique em **Continuar** para criar a integração.

### 5. Escolha o instalador

Em **Selecione um instalador**:

1. Selecione **Sim, vou instalar esta integração** se gere a integração do AirOps para a sua empresa.
2. Clique em **Continuar** para aceder a **Instruções de configuração de SSO**.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-9866733f83400a6d74636dba862b0821f38f6482%2Frippling-sso-installer-full.svg?alt=media" alt="Rippling installer selection screen with numbered callouts for choosing the installer and continuing"><figcaption><p>Selecione a pessoa que vai configurar a ligação. A captura de ecrã mostra o formulário antes de ser feita uma escolha.</p></figcaption></figure>

Para uma instalação existente, abra **Acesso → Início de sessão único (SSO) → Configuração** e clique em **Reconfigurar** em **Geral** para reabrir o assistente.

### 6. Copie ou descarregue o XML de metadados do Rippling

Em **Instruções de configuração de SSO**, encontre **Passo 1 - Introduzir campos de configuração SAML**, depois localize **Metadados do IdP**. Este XML contém os detalhes de ligação do Rippling de que o AirOps precisa.

Escolha uma opção:

* **Descarregar o XML:** Clique no ícone de transferência à direita de **Metadados do IdP** e guarde o ficheiro. Irá carregá-lo para o AirOps no passo 8.
* **Copiar o XML:** Copie o conteúdo XML completo de **Metadados do IdP**. Mude para o separador do AirOps e cole-o em **Ou colar XML de metadados** agora e depois volte ao Rippling. Mantenha o formulário do AirOps aberto.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-44ef5f9ff6b79bd19ac24d3bda9c7ad150213073%2Frippling-sso-05-rippling-metadata.jpg?alt=media" alt="Rippling IdP Metadata section showing the XML contents and its download icon"><figcaption><p>Copie ou descarregue o XML completo de metadados do IdP para a configuração do AirOps.</p></figcaption></figure>

Para uma app instalada, a transferência também está disponível em **Acesso → Início de sessão único (SSO) → Configuração → Metadados → XML de metadados**.

Mantenha a página de configuração do Rippling aberta para introduzir os URLs do AirOps a seguir.

### 7. Cole os URLs do AirOps no Rippling

Na mesma **Instruções de configuração de SSO** página, desça até **Passo 2 - Fornecer metadados do fornecedor de serviços**. Copie cada valor do formulário do AirOps para o respetivo campo do Rippling:

| Campo do Rippling                            | Valor a colar                          |
| -------------------------------------------- | -------------------------------------- |
| **URL do Assertion Consumer Service**        | O seu AirOps **URL ACS**.              |
| **ID de entidade do fornecedor de serviços** | O seu AirOps **ID de entidade do SP**. |

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-fc52a7014db2a452acddf222c3546301e832bef4%2Frippling-sso-02-rippling-endpoints.jpg?alt=media" alt="Rippling SSO setup instructions showing Assertion Consumer Service URL and Service Provider Entity ID"><figcaption><p>A captura de ecrã mostra URLs de exemplo de um espaço de trabalho AirOps. Copie os URLs gerados para o seu próprio espaço de trabalho e ambiente.</p></figcaption></figure>

Estes dois campos fornecem os metadados do fornecedor de serviços. Pode deixar os campos alternativos **URL de metadados** quanto no **Metadados** vazios ao usar este método.

Deixe o Rippling aberto e volte para o AirOps.

### 8. Guarde a ligação no AirOps

No formulário do AirOps que deixou aberto:

1. Se descarregou o XML no passo 6, escolha **Carregar XML de metadados do IdP** e selecione o ficheiro. Se o copiou, use o conteúdo já colado em **Ou colar XML de metadados**.
2. Clique em **Rever metadados**.
3. Verifique o **ID de entidade do IdP**, **URL de SSO**, e **Certificados de assinatura**.
4. Introduza os nomes exatos dos atributos configurados na sua app Rippling. **Os nomes abaixo são exemplos; a sua app pode usar nomes diferentes.** Veja [passo 16: Configurar os atributos do colaborador](#16-configure-the-employee-attributes) para os verificar ou criar antes de testar o início de sessão.

| Campo do AirOps                        | Exemplo          | O que introduzir para a sua ligação                                                                                     |
| -------------------------------------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Formato NameID**                     | **emailAddress** | O mesmo formato NameID configurado no Rippling.                                                                         |
| **Atributo de e-mail profissional**    | `emailAddress`   | O nome exato do atributo que o Rippling usa para enviar o e-mail profissional do colaborador.                           |
| **Atributo do primeiro nome**          | `firstName`      | O nome exato do atributo que o Rippling usa para enviar o primeiro nome do colaborador.                                 |
| **Atributo do último nome (opcional)** | `lastName`       | O nome exato do atributo que o Rippling usa para enviar o último nome do colaborador. Deixe em branco se não for usado. |
| **Função predefinida**                 | **Membro**       | Escolha a função do AirOps que os novos membros do espaço de trabalho devem receber.                                    |

Estes campos contêm nomes de atributos. O Rippling fornece o e-mail e o nome reais do colaborador quando este inicia sessão.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-a73f137f2c676a7da8f47c82cc2f5b0a3f8f5ead%2Fsso-rippling-02-attributes.png?alt=media" alt="Rippling SAML connection with NameID format emailAddress, the emailAddress, firstName, and lastName attributes, and Member as the default role"><figcaption><p>Configuração de exemplo. Use os nomes de atributos do Rippling e escolha a função do AirOps para os novos membros.</p></figcaption></figure>

Clique em **Adicionar ligação**. Confirme que o AirOps mostra **Ligação Rippling guardada.**

{% hint style="info" %}
O **ID de entidade do IdP** importado identifica o Rippling. O **ID de entidade do SP** que copiou no passo 1 identifica o espaço de trabalho AirOps. Cada um pertence ao seu próprio lado da ligação.
{% endhint %}

### 9. Defina as regras de acesso da app de SSO

Regresse ao **Instruções de configuração de SSO** Rippling **e clique em**Mover para o passo seguinte **regras de acesso da app de SSO**, escolha quem deve receber a app AirOps:

1. Utilize **Atribuir um grupo** para atribuir o seu grupo-piloto, ou **Atribuir um indivíduo** para atribuir o seu colaborador de teste. Pode usar qualquer um dos métodos.
2. Rever **Grupos atribuídos**, **Indivíduos atribuídos**, e **Exclusões**. Mantenha a atribuição inicial limitada às pessoas do seu piloto.
3. Clique em **Continuar**.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-dddcad45377a78d57a8daa11cbd0c244500afba0%2Frippling-sso-access-rules-full.svg?alt=media" alt="Full Rippling SSO app access rules screen with numbered boxes and arrows around the group assignment, individual assignment, and Continue controls"><figcaption><p>Atribua a app ao seu colaborador de teste ou grupo-piloto. A elegibilidade de SSO é uma escolha separada no passo 14.</p></figcaption></figure>

### 10. Reveja o timing do acesso

Em **Tempo de aprovisionamento**, **Tempo de acesso do novo colaborador** determina quando alguém que corresponde às regras de acesso da app se torna elegível para acesso.

| Opção                                                         | Quando o acesso fica disponível                                                 |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| **Assim que tenham assinado a sua carta de oferta ou acordo** | Depois de o colaborador assinar a oferta ou o acordo.                           |
| **Na data de início, não antes**                              | Na data de início do colaborador.                                               |
| **Um horário fixo antes da data de início**                   | No intervalo que configurar antes da data de início do colaborador.             |
| **Assim que o administrador os contratar**                    | Quando o administrador contrata o colaborador, antes de este assinar um acordo. |

Selecione o timing que melhor se adequa ao processo de onboarding e às políticas de acesso da sua organização e, depois, clique em **Continuar**. O AirOps cria uma nova conta elegível no primeiro início de sessão bem-sucedido, sujeito às restrições de registo.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-48af3406e4495e5a900210991f747f681e9e8ff6%2Frippling-sso-provision-time-full.svg?alt=media" alt="Full Rippling Provision time screen highlighting the available access timing options and Continue"><figcaption><p>A opção selecionada é um exemplo. Escolha o timing que se adequa às políticas da sua organização.</p></figcaption></figure>

### 11. Reveja as opções de SSO do administrador

Em **SSO para administrador**, o Rippling pergunta se os administradores do Rippling da sua empresa devem poder iniciar sessão numa conta de administrador partilhada do AirOps.

| Opção                                                                                                                | O que controla                                                                                                                  |
| -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Permitir que os administradores de \[a sua empresa] iniciem sessão na conta de administrador de \[a sua app]**     | O Rippling dá aos administradores com acesso total acesso à conta designada como a conta de administrador partilhada da app.    |
| **Não permitir que os administradores de \[a sua empresa] iniciem sessão na conta de administrador de \[a sua app]** | Mantém desativado o acesso partilhado de administrador. Os administradores ainda podem usar SSO com as suas contas individuais. |

Para esta configuração, recomendamos selecionar **Não permitir que os administradores de \[a sua empresa] iniciem sessão na conta de administrador de \[a sua app]** para que cada pessoa inicie sessão com a sua própria conta AirOps. Os administradores do AirOps ainda podem usar SSO e manter as respetivas funções atribuídas no espaço de trabalho.

Depois de rever a definição, clique em **Continuar**. Faça a gestão das funções de espaço de trabalho dos utilizadores individuais no AirOps.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-db7c7ba0da198a6319fb2f9847411972a2085ece%2Frippling-sso-admin-sso-full.svg?alt=media" alt="Full Rippling Shared Admin SSO screen highlighting the recommended Don&#x27;t let option and Continue"><figcaption><p>A captura de ecrã mostra a opção recomendada para esta configuração. Os nomes da empresa e da app corresponderão à sua integração.</p></figcaption></figure>

### 12. Reveja os atributos de grupo opcionais

**Atributos de grupo** permitem que o Rippling inclua valores relacionados com grupos na resposta de início de sessão SAML. Por exemplo, um atributo `grupos` poderia enviar `Engenharia` para colaboradores do seu grupo de Engenharia.

Reveja quaisquer atributos de grupo já configurados para a sua app. Se a configuração SAML da sua organização exigir informação adicional de grupo, use **Criar novo** para definir os valores e as pessoas a quem se aplicam. Também pode continuar sem adicionar atributos de grupo.

Para o AirOps, estes atributos são opcionais e não atribuem funções no espaço de trabalho. Os novos membros do espaço de trabalho recebem a **Função predefinida** selecionada no passo 8; os membros ativos existentes mantêm as suas funções. As atribuições da app e a elegibilidade de SSO são configuradas separadamente nos passos 9 e 14. Os atributos de e-mail e nome do colaborador são configurados no passo 16.

Depois de rever a configuração, clique em **Continuar**.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1fe53e2abbc0baa7c71d5f6ba24496abb90fd253%2Frippling-sso-group-attributes-full.svg?alt=media" alt="Full Rippling Group attributes screen for AirOps SSO showing no configured group attributes and highlighting Continue"><figcaption><p>Este exemplo não tem atributos de grupo configurados. Configure valores opcionais para se adequarem à configuração da sua organização.</p></figcaption></figure>

### 13. Adie o teste inicial da ligação

A **Verificar a integração SSO** o passo mostra **Testar a ligação do Rippling ao \[seu app]** e um botão **Ligar via Rippling** .

Os atributos do colaborador e as definições do painel ainda precisam de ser revistos após a instalação. Clique **Continuar** por agora e volte a este teste no passo 19. Prosseguir para além deste ecrã não confirma um início de sessão bem-sucedido.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-5349c853c1ae22549b809c3df02ffdae1b7d5599%2Frippling-sso-connection-test-full.svg?alt=media" alt="Full Test Rippling&#x27;s connection screen highlighting only Continue"><figcaption><p>Clique em Continuar para continuar a configurar a app. Execute o teste de ligação no passo 19.</p></figcaption></figure>

{% hint style="info" %}
O texto genérico de teste do Rippling menciona a criação e desativação de utilizadores. Esta configuração SAML cria novas contas AirOps elegíveis no início de sessão. Não configura o SCIM nem remove automaticamente a participação no AirOps quando uma atribuição no Rippling é removida.
{% endhint %}

### 14. Escolha quais os utilizadores atribuídos que podem iniciar sessão com SSO

Em **Elegibilidade de SSO**, a página pergunta **Quais os utilizadores atribuídos que podem iniciar sessão com SSO?**:

1. Escolha **Todos os utilizadores atribuídos** se todos os atribuídos no passo 9 devem usar SSO. Para testar o SSO com um subconjunto menor dos utilizadores atribuídos à app, escolha **Apenas os utilizadores atribuídos selecionados** e inclua o seu colaborador de teste nas regras que aparecem.
2. Rever **Excluir utilizadores (opcional)** e verifique que o seu colaborador de teste não está excluído. Use **Pré-visualizar pessoas** para verificar o resultado de quaisquer regras.
3. Clique em **Continuar**.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-884b2ba441aa1c86691228b058c0bf61ca4f9eea%2Frippling-sso-sso-eligibility-full.svg?alt=media" alt="Full Rippling SSO Eligibility screen highlighting All assigned users or Only selected assigned users, exclusion rules, and Continue"><figcaption><p>Um colaborador deve ter tanto uma atribuição da app como elegibilidade para SSO. A captura de ecrã mostra Todos os utilizadores atribuídos selecionado.</p></figcaption></figure>

### 15. Conclua a instalação e abra a Configuração

Conclua quaisquer restantes pedidos apresentados pelo Rippling para a sua instalação. Quando chegar a **instalação de \[a sua app] concluída**, clique em **Ir para a integração**.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-072c9125d3994f115872f7d80cc343547028ed95%2Frippling-sso-installation-complete-full.svg?alt=media" alt="Full Rippling installation complete screen with a numbered arrow pointing to Go to integration"><figcaption><p>Abra a app instalada para rever os respetivos atributos do colaborador e definições avançadas.</p></figcaption></figure>

Na sua integração AirOps:

1. Selecione **Acesso**.
2. Selecione **Início de sessão único (SSO)**.
3. Abrir **Configuração**.

Mantenha esta página aberta para os atributos do colaborador e as definições avançadas abaixo.

### 16. Configure os atributos do colaborador

Em **Rippling**, abra a sua integração AirOps e aceda a **Acesso → Início de sessão único (SSO) → Configuração → Atributos SAML**.

Primeiro, encontre os atributos para e-mail profissional, primeiro nome e último nome opcional na coluna **Nome** . Reutilize atributos existentes e crie apenas as mapeações em falta.

A tabela abaixo mostra nomes de exemplo e campos de colaborador. Os nomes dos seus atributos podem ser diferentes; cada nome deve corresponder ao campo correspondente no AirOps.

| Campo do AirOps do passo 8             | Nome de atributo Rippling de exemplo | Valor de colaborador Rippling de exemplo                                                                               |
| -------------------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| **Atributo de e-mail profissional**    | `emailAddress`                       | **Endereço de e-mail do utilizador**, contendo o e-mail profissional do colaborador.                                   |
| **Atributo do primeiro nome**          | `firstName`                          | **Primeiro nome preferido do utilizador**.                                                                             |
| **Atributo do último nome (opcional)** | `lastName`                           | **Último nome preferido do utilizador**. Omitir este mapeamento se o campo do último nome estiver em branco no AirOps. |

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-866aef3dabc10630713be92a856b5e67790c2b0b%2Frippling-sso-03-rippling-attributes.jpg?alt=media" alt="Rippling SAML attributes table showing emailAddress, firstName, and lastName mapped to employee fields"><figcaption><p>O AirOps SSO usa neste exemplo os nomes preferidos e último nome. A coluna Name tem de corresponder aos nomes dos atributos guardados no AirOps.</p></figcaption></figure>

**Criar um atributo em falta**

Para cada linha em falta:

1. Clique em **Criar novo** em **Atributos SAML**.
2. Em **Criar atributo SAML**, selecione **Atributo global**. Isto permite mapear um campo do colaborador para cada pessoa que inicia sessão.
3. Em **Nome do atributo global**, introduza o nome que também irá usar no AirOps. Por exemplo, introduza `firstName` para uma nova mapeação de primeiro nome.
4. Abrir **Valor** e selecione o campo de colaborador correspondente. Para `firstName`, escolha **Primeiro nome preferido do utilizador**. Selecione o campo na lista pendente para que o Rippling use o valor do colaborador que está a iniciar sessão.
5. Clique em **Guardar**, depois verifique que a linha aparece em **Atributos SAML**.
6. Repita para qualquer mapeamento em falta de e-mail profissional ou último nome, usando os nomes de atributos escolhidos e os respetivos campos de colaborador. A tabela mostra `emailAddress` quanto no `lastName` como exemplos. Ignore qualquer mapeamento que já exista.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-7ecfc5baa42f448c6bcaf8fb0a5dc607a772ddac%2Frippling-sso-create-employee-attribute-full.svg?alt=media" alt="Rippling Create SAML attribute form with numbered callouts for Global attribute, the firstName name, the dynamic Preferred first name value, and Save"><figcaption><p>Exemplo de criação de firstName quando em falta. Use a tabela acima para emailAddress e lastName. A captura de ecrã mostra um formulário não guardado.</p></figcaption></figure>

**Verificar ou corrigir um atributo existente**

1. Abra o menu da linha do atributo e escolha **Editar**.
2. Verificação **Valor** em relação à tabela e selecione o campo de colaborador correspondente, se necessário.
3. Clique em **Guardar** se alterou o valor. Repita para os outros atributos existentes.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f4a30675e85a29519c7a349ca5fb299c87fb8412%2Frippling-sso-03-rippling-attribute-editor.jpg?alt=media" alt="Rippling Edit SAML attribute dialog showing firstName and the Value dropdown set to User&#x27;s Preferred first name"><figcaption><p>Edite uma linha existente em vez de criar um duplicado.</p></figcaption></figure>

**Corresponder aos nomes no AirOps**

Os valores do Rippling **Nome** devem corresponder ao **Atributo de e-mail profissional**, **Atributo do primeiro nome**e ao opcional **Atributo do último nome** que guardou no passo 8. Se usou nomes diferentes, abra **AirOps → Definições → Início de sessão único → Rippling → Ações → Atualizar credenciais**, introduza esses nomes exatos e clique em **Guardar ligação**. O Rippling fixa os nomes dos seus atributos predefinidos, por isso use os nomes que a sua app realmente envia.

{% hint style="info" %}
Os nomes diferenciam maiúsculas de minúsculas. Por exemplo, se o seu atributo de e-mail profissional no Rippling se chamar `emailAddress`, introduza `emailAddress` no AirOps e selecione **Endereço de e-mail do utilizador** como o respetivo valor dinâmico no Rippling. O AirOps requer o atributo de e-mail mesmo quando o NameID contém um e-mail. O **Atributos de grupo** ecrã no assistente de onboarding não configura estes campos de identidade do colaborador.
{% endhint %}

### 17. Faça corresponder o formato NameID e as definições de assinatura

Desça até **Definições avançadas** e clique em **Editar**.

O exemplo neste guia usa **emailAddress** para **Formato NameID predefinido a ser usado**:

```
urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress
```

Escolha o formato que corresponde à sua ligação AirOps. Mantenha **Estado de retorno predefinido** em branco.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f82be7ba5d74c0859f7e37906f25681c96d63f75%2Frippling-sso-04-nameid.jpg?alt=media" alt="Rippling advanced settings showing emailAddress as the default NameID format and a blank default relay state"><figcaption><p>Use o mesmo formato NameID no Rippling e no AirOps.</p></figcaption></figure>

Verifique as restantes definições:

| Definição                                 | Valor                       |
| ----------------------------------------- | --------------------------- |
| **Algoritmo de assinatura**               | **RSA-SHA256** recomendado. |
| **Algoritmo de resumo para as asserções** | **SHA-256** recomendado.    |
| **Criptografar asserções**                | **Não**.                    |

A AirOps requer uma asserção SAML assinada. Assinar apenas a resposta não cumpre esse requisito.

Se estiver a atualizar uma ligação existente, mantenha o respetivo valor NameID estável e o formato, e corresponda-os na AirOps. Mantenha-se em **Definições avançadas** para o próximo passo.

### 18. Ativar acesso rápido ao painel

No mesmo **Definições avançadas** formulário, defina:

| Definição                                                                                                               | Valor                                           |
| ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| **Desative o campo 'InResponseTo' nas asserções para SSO iniciado pelo IdP**                                            | **Sim**                                         |
| **A aplicação só suporta início de sessão iniciado a partir da aplicação, também designado por fluxo iniciado pelo SP** | **Não**                                         |
| **Desative a normalização automática de atributos**                                                                     | **Sim**, para preservar os nomes dos atributos. |

Clique em **Guardar**, depois reabra **Definições avançadas** e verifique os valores guardados.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-3f9e670465251d3f32189a17710105f6ad73e8d6%2Frippling-sso-04-rippling-quick-access.jpg?alt=media" alt="Saved Rippling advanced settings with Disable InResponseTo set to Yes and SP-initiated-only set to No"><figcaption><p>Confirme os dois valores de acesso rápido depois de guardar: Sim para Desativar InResponseTo e Não para Apenas iniciado pelo SP.</p></figcaption></figure>

A `InResponseTo` a opção aplica-se a lançamentos do painel. As respostas a um início de sessão iniciado a partir da AirOps devem ainda corresponder ao pedido original. A Rippling descreve as opções disponíveis na sua [referência de SSO SAML](https://developer.rippling.com/documentation/developer-portal/v2-guides/saml).

### 19. Testar a ligação concluída

Ambos os lados estão agora guardados. Mantenha a sessão de administrador da AirOps aberta e teste o início de sessão num perfil de navegador separado ou numa janela privada.

Se estiver a ligar uma conta AirOps existente pela primeira vez, siga [Ligar uma conta AirOps existente](#connect-an-existing-airops-account) antes de testar um início de sessão sem autenticação.

**Inicie sessão a partir da AirOps**

1. Abra o [Página de início de sessão da AirOps](https://app.airops.com/users/sign_in).
2. Clique em **Iniciar sessão com a Rippling** para mostrar o **slug do espaço de trabalho** campo.
3. Introduza o slug do espaço de trabalho da AirOps e clique em **Continuar**.
4. A AirOps redireciona-o para a Rippling. Inicie sessão com a sua conta Rippling e conclua quaisquer pedidos de autenticação. Se já tiver uma sessão Rippling ativa, a Rippling pode continuar sem lhe pedir novamente para iniciar sessão.
5. A Rippling devolve-o à AirOps. Confirme que o seu espaço de trabalho abre e que consegue aceder-lhe com a função esperada.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f3d9f24bd63e5db30df157e5f34454b28b7bfb33%2Frippling-sso-07-airops-sign-in.png?alt=media" alt="AirOps sign-in flow: choose Sign in with Rippling, enter the workspace slug and click Proceed, authenticate with Rippling, and return to the AirOps workspace"><figcaption><p>Selecione Iniciar sessão com a Rippling, introduza o slug do seu espaço de trabalho e clique em Continuar.</p></figcaption></figure>

**Inicie sessão a partir do painel da Rippling**

1. Abra a Rippling e clique no mosaico de acesso rápido da AirOps.
2. Na página de continuação da AirOps, clique em **Continuar para o espaço de trabalho**.
3. Conclua quaisquer pedidos de início de sessão da Rippling e confirme que chega ao espaço de trabalho da AirOps pretendido.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-b7a06114c36d8a1488a5ea9348572d553091e8ca%2Frippling-sso-06-sign-in.png?alt=media" alt="Rippling quick-access flow: AirOps tile, Continue to workspace, Rippling verification, and AirOps workspace"><figcaption><p>A página de continuação da AirOps é uma parte esperada do início de sessão no painel.</p></figcaption></figure>

**Reveja o teste de ligação da Rippling**

Também pode voltar ao **Ligar via Rippling** teste:

1. Em **Configuração → Geral**, clique em **Reconfigurar**.
2. Abra o seletor de passos no canto superior esquerdo e selecione **Verificar a integração SSO**.
3. Verifique o email do colaborador apresentado em **Testar a ligação da Rippling**, depois clique em **Ligar via Rippling**.
4. Conclua o início de sessão. Se a AirOps mostrar **Continuar para o espaço de trabalho**, clique nele e confirme que chega ao espaço de trabalho pretendido.

Se um teste falhar, verifique a configuração antes de considerar a configuração como concluída. Concluir apenas o assistente da Rippling não verifica a ligação à AirOps.

Verifique se um novo membro recebe a função predefinida configurada e se um membro ativo existente mantém a sua função.

## Referência de configuração da AirOps

| Campo                                  | O que introduzir                                                                                                                                              |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **URL ACS / ID de entidade SP**        | Gerado pela AirOps. Copie ambos para a aplicação SAML da Rippling.                                                                                            |
| **XML de metadados do IdP**            | Exporte da aplicação Rippling correspondente. Carregue ou cole um ficheiro até 250 KB e depois clique em **Rever metadados**.                                 |
| **Formato NameID**                     | Corresponda ao formato da Rippling e utilize um identificador de colaborador estável. Mantenha o identificador e o formato consistentes após a implementação. |
| **Atributo de e-mail profissional**    | Nome exato do atributo SAML, sensível a maiúsculas e minúsculas, que contém o email de trabalho do colaborador. Obrigatório.                                  |
| **Atributo do primeiro nome**          | Nome exato do atributo SAML que contém o primeiro nome do colaborador. Obrigatório.                                                                           |
| **Atributo do último nome (opcional)** | Nome exato do atributo SAML que contém o apelido do colaborador. Deixe em branco se for omitido.                                                              |
| **Função predefinida**                 | Função para novos membros do espaço de trabalho. Os membros ativos existentes mantêm a sua função atual.                                                      |

Para atualizar uma ligação, abra **Definições → Início de sessão único → Rippling → Ações → Atualizar credenciais**, faça as alterações e clique em **Guardar ligação**. Importe novos metadados quando a Rippling alterar os respetivos certificados de assinatura, antes de os certificados existentes expirarem.

## Exemplos de início de sessão

### Partilhe as instruções de início de sessão

Partilhe o [Página de início de sessão da AirOps](https://app.airops.com/users/sign_in) e o slug do seu espaço de trabalho com os colaboradores. Podem selecionar **Iniciar sessão com a Rippling**, introduzir o slug e clicar em **Continuar**.

Os colaboradores também podem usar o mosaico SAML da AirOps no respetivo painel da Rippling.

### Ligar uma conta AirOps existente

No primeiro início de sessão na Rippling numa conta AirOps existente:

1. Inicie sessão na AirOps usando o método de início de sessão atual da conta.
2. Na **mesmo perfil de navegador**, abra o mosaico SAML da AirOps no seu painel da Rippling e clique em **Continuar para o espaço de trabalho**.
3. Conclua o início de sessão na Rippling usando o email de trabalho correspondente.

Depois de a conta estar ligada, teste um início de sessão sem autenticação. Se a AirOps lhe pedir para usar o seu fornecedor original de início de sessão, contacte a equipa da sua conta AirOps para organizar a transição.

### Compreender o comportamento da associação

A AirOps cria uma nova conta e associação ao espaço de trabalho durante o primeiro início de sessão bem-sucedido do colaborador, sujeito às restrições de registo do seu espaço de trabalho. Esta ligação SSO não sincroniza a associação ou as funções do colaborador através de SCIM. Faça a gestão da associação existente na AirOps separadamente ao remover acesso.

## Resolução de problemas

| O que vê                                                                     | O que verificar                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Rippling** está em falta nas definições ou no início de sessão da AirOps   | Peça à equipa da sua conta AirOps para ativar a Rippling para o espaço de trabalho.                                                                                                                                                                                                                                                                                                                  |
| **Não foi possível verificar o início de sessão da Rippling**                | Confirme que o URL ACS e o ID de entidade SP correspondem ao mesmo espaço de trabalho e ambiente da AirOps. Volte a verificar os metadados, a validade do certificado, o formato NameID e a definição de asserção assinada. Para lançamentos do painel, verifique também ambos os alternadores de acesso rápido no passo 18 e deixe o Estado Relay predefinido em branco. Inicie uma nova tentativa. |
| Falta um atributo de email ou de primeiro nome                               | Corresponda aos nomes exatos dos atributos, incluindo maiúsculas e minúsculas. Selecione campos de colaborador como valores na Rippling e confirme que o colaborador atribuído tem esses valores preenchidos.                                                                                                                                                                                        |
| O mosaico de acesso rápido abre a página geral de início de sessão da AirOps | Confirme que o mosaico abre a aplicação SAML, em vez de um marcador para a página de início de sessão. Reabra e verifique as definições de acesso rápido no passo 18.                                                                                                                                                                                                                                |
| A AirOps pede-lhe primeiro para iniciar sessão numa conta existente          | Siga **Ligar uma conta AirOps existente** acima no mesmo perfil de navegador.                                                                                                                                                                                                                                                                                                                        |
| **Adicionar ligação** não está disponível                                    | Importe os metadados e clique em **Rever metadados**. Reveja novamente se alterar o XML.                                                                                                                                                                                                                                                                                                             |
| A função de um membro existente não foi alterada                             | A função predefinida aplica-se aos novos membros. Atualize a função do membro existente na AirOps.                                                                                                                                                                                                                                                                                                   |

Se o início de sessão continuar a falhar, partilhe o slug do espaço de trabalho, o ponto de entrada, a hora da tentativa e o erro apresentado com o suporte da AirOps. Não inclua uma resposta SAML nem tokens de sessão.


---

# 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.airops.com/docs/pt/o-seu-espaco-de-trabalho/team/rippling-sso.md?ask=<question>&goal=<user_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.
