Centro de suporte da Workiva

Os administradores de segurança da organização podem seguir as etapas abaixo para configurar as configurações de logon único SAML para a organização. O logon único (SSO) baseado em SAML dá aos membros acesso à Workiva por meio de um provedor de identidade (IdP). Antes de definir as configurações, verifique se você revisou O que é o logon único SAML?.

Observação: Os administradores de segurança da organização devem ser adicionados a um espaço de trabalho para que você possa acessar o Organization Admin.

Etapa 1: Navegue até as configurações de SAML SSO

1. Vá para Organization Admin.
2. Clique em Segurança no menu à esquerda.
3. Clique na aba Single Sign-On.

Se você já possui uma configuração de SSO, a página terá esta aparência:

Etapa 2: Crie sua configuração de SSO SAML e selecione seu provedor de identidade.

1. Clique em Criar configuração SSO.
2. Insira um nome de configuração e selecione o provedor de identidade (IdP) na lista suspensa.
3. Clique em Criar configuração para prosseguir.

Etapa 3: Envie os metadados do Workiva para o administrador do seu provedor de identidade.

1. Na seção Metadados do Workiva , você verá o Identificador (ID da Entidade) e URL de Resposta.
2. Clique em Opções avançadas para ver o URL de login e URL de logout.
   Estes URLs são exclusivos de cada organização e não podem ser modificados, e conterão app.wdesk.com, eu.wdesk.comou apac.wdesk.com.
   
3. Envie esses URLs de metadados da Workiva para o administrador do seu provedor de identidade.
   Você também pode clicar em Baixar XML de metadados do Workiva para baixar e enviar o arquivo XML de metadados do Workiva para o administrador do seu provedor de identidade.

4. Você pode ajustar sua Tolerância de Desvio de Relógio. A tolerância de distorção de relógio é a diferença máxima de tempo permitida entre o seu provedor de identidade SAML e a Workiva. O valor padrão é de 300 segundos (5 minutos).

   Dica: Um valor maior amplia a "janela de aceitação" para diferenças de tempo. Embora isso melhore a confiabilidade ao reduzir as solicitações rejeitadas, também introduz riscos de segurança e desempenho. Por outro lado, um valor menor aumenta a probabilidade de falhas de autenticação devido a tempos limite excedidos.

5. Se estiver usando o Microsoft Azure como seu provedor de identidade, o administrador do seu provedor de identidade pode consultar a Etapa 2 na guia Azure em Configurar SSO SAML com seu provedor de identidade.
6. Se estiver usando o Okta como seu provedor de identidade, o administrador do seu provedor de identidade pode consultar a Etapa 3 na guia Okta em Configurar SSO SAML com seu provedor de identidade.
7. Se você estiver usando um provedor de identidade diferente do Microsoft Azure ou Okta, entre em contato com o suporte ao cliente do seu provedor de identidade caso precise de ajuda.

Etapa 4: Insira os metadados do seu provedor de identidade no Workiva.

Pré-requisito: Você precisa obter as informações de metadados do provedor de identidade necessárias do administrador do seu provedor de identidade antes de prosseguir.

• Se você estiver usando o Microsoft Azure como seu provedor de identidade, o administrador do seu provedor de identidade pode consultar a Etapa 4 na guia Azure em Configurar SSO SAML com seu provedor de identidade.
• Se você estiver usando o Okta como seu provedor de identidade, o administrador do seu provedor de identidade pode consultar a Etapa 2 na guia Okta em Configurar SSO SAML com seu provedor de identidade.
• Se estiver usando um provedor de identidade diferente do Microsoft Azure ou Okta, entre em contato com o suporte ao cliente do seu provedor de identidade para obter as informações.

Na seção de metadados do provedor de identidade (por exemplo, Metadados do Microsoft Azure), insira os metadados do provedor de identidade.

1. Primeiro, no menu suspenso Método de entrada preferido , selecione como você deseja inserir os metadados do provedor de identidade. Você pode inserir um URL de metadados de federação, carregar um arquivo XML de metadadosou inserir os metadados por meio de Entrada manual.
   

2. Na caixa de diálogo de seleção de arquivos, selecione o arquivo que contém as informações de metadados do provedor de identidade e clique em Importar.

   

   Alternativamente, você pode inserir os valores manualmente:
   

Etapa 5: Configurar mapeamento de usuários

Na seção Mapeamento de usuários, clique no menu suspenso e selecione uma das seguintes opções:

• Mapear usuários para seus nomes de usuário do Workiva (recomendado)
• Mapear usuários manualmente

Nota: Se você inseriu manualmente as informações de metadados do provedor de identidade, você precisará ativar as Opções avançadas para esta seção.

Mapeamento de usuários para seus nomes de usuário do Workiva.

Se você selecionou Mapear usuários para seus nomes de usuário do Workiva no menu suspenso, o Workiva esperará que o atributo Primary NameID recebido corresponda ao nome de usuário do Workiva, ignorando qualquer distinção entre maiúsculas e minúsculas, quando o usuário fizer login. Por exemplo, isso permite que User.Name.Example faça a correspondência com user.name.example.

Você pode então clicar no menu suspenso Definir mapeamento e selecionar Definir todos os IDs SSO para o nome de usuário Workiva para preencher a tabela.

Clique em Criar configuração para prosseguir.

Mapeamento manual de usuários

Se você selecionou Mapear usuários manualmente no menu suspenso, verifique primeiro as opções avançadas. Em NameIdentifier location, a maioria das configurações terá a opção NameIdentifier is in Subject statement selecionada. Isso significa que o Workiva verificará a presença do elemento NameIdentifier na declaração Subject.

No entanto, você pode selecionar a opção NameIdentifier está em um atributo de elemento diferente e inserir o atributo de elemento NameIdentifier, para que o aplicativo procure o atributo na resposta SAML.

Nota: A maioria dos administradores de segurança da organização não alterará o local do NameIdentifier do padrão. Antes de efetuar alterações, entre em contato com o Suporte da Workiva para obter assistência

Mapear usuários por meio da importação de arquivos

Clique em Definir mapeamentoe selecione Importar IDs SSO via arquivo para mapear usuários aos IDs SSO em um arquivo de mapeamento .csv (consulte Requisitos do arquivo de mapeamento .csv de ID SAML).

• Não são necessários cabeçalhos no arquivo de mapeamento.
• Todas as linhas serão processadas e as linhas inválidas serão ignoradas.
• Caso haja nomes de usuário duplicados, apenas a primeira linha com esse nome de usuário será utilizada.
• Se um nome de usuário fornecido já tiver um mapeamento existente, seu mapeamento será atualizado para o que estiver fornecido no arquivo de mapeamento.
• Se linhas forem ignoradas, as falhas serão registradas no log de atividades de logon único SAML.

Usuários do mapa individualmente

Se você precisar definir ou editar IDs SSO para usuários individualmente, pesquise o usuário e/ou use o filtro Status do ID SSO para encontrar o usuário mais facilmente. Em seguida, na tabela, clique duas vezes no campo ID SSO ao lado do usuário e insira o ID SSO correto.

Após configurar o mapeamento de usuários, clique em Criar configuração para prosseguir.

Requisitos do arquivo de mapeamento SAML ID .csv

Uma linha válida no arquivo de mapeamento SAML ID .csv segue o seguinte formato:

samlId, nome de usuário

Uma linha pode ser inválida se:

• Há menos de dois itens na linha
• A ID SAML e/ou o nome de usuário não são fornecidos
• O nome de usuário fornecido não existe
• O usuário com o nome de usuário fornecido não é um membro da organização
• A organização principal do usuário com o nome de usuário fornecido não é a mesma que a organização que está sendo modificada no momento
• A ID SAML fornecida já foi usada por um usuário diferente

Um exemplo de arquivo de mapeamento válido é o seguinte:

exemploSamlId, exemploNomeDeUsuário exemploSamlId2, exemploNomeDeUsuário2 exemploSamlId3, exemploNomeDeUsuário3

Etapa 6: Ative sua configuração de SSO SAML

Após criar sua configuração de SSO SAML, você precisará ativá-la explicitamente para que a configuração entre em vigor.

Clique em Ativar na configuração. Sua configuração será exibida como Ativa.

Etapa 7: Atualize as opções de autenticação SSO SAML

A Workiva recomenda enfaticamente que você obrigue os usuários a fazer login usando SSO (Single Sign-On) como uma prática recomendada para simplificar o processo de login e proporcionar uma experiência geral melhor. Após criar e ativar sua configuração de SSO SAML:

1. Na aba Single sign-on, a seção Force SSO and exceptions apresenta duas opções de autenticação:

   • Forçar usuários a fazer login usando SSO (Recomendado): Usuários sem privilégios de administrador são forçados a usar SSO, enquanto os administradores de segurança da organização podem continuar a fazer login usando seu nome de usuário e senha. Essa opção é ideal se sua empresa deseja impor o SSO, mas ainda permitir que os administradores de segurança da organização acessem a plataforma caso o SSO apresente algum problema.

     Nota: Certifique - se de realizar testes abrangentes e de ter total confiança na sua configuração de SSO SAML antes de ativar esta opção.

   • Forçar administradores de segurança da organização a entrar usando SSO: Os administradores de segurança da organização são forçados a usar SSO. Essa opção é mais adequada se as políticas de segurança da empresa não isentarem os usuários da exigência de SSO (Single Sign-On). Para ativar esta opção, você também precisará marcar Forçar usuários a fazer login usando SSO.
     
2. Após selecionar suas opções, clique em Salvar.

Se desejar, você pode permitir que usuários específicos façam login sem SSO SAML adicionando-os à lista de exceções deSSO .

Nota: Antes de forçar o SSO SAML, certifique-se de adicionar os usuários necessários à lista de exceções de SSO para evitar o bloqueio de suas contas.