Como adicionar novos atributos no Okta

Este artigo explica como adicionar novos atributos quando a comunicação entre a Miro e o Okta para SCIM e/ou logon único já está configurada corretamente.

Como configurar o logon único (SSO) do Okta
Como configurar o SCIM do Okta
Licença Okta Guia de provisionamento para FLP (como criar e atribuir o atributo de licença)
Como configurar o Foto do perfil para o fluxo de logon único (quando o SCIM estiver desabilitado)

O único valor exigido pela Miro é userName, e o atributo deve estar no formato de um e-mail. Outros atributos não são obrigatórios, mas alguns serão aceitos pela Miro se estiverem presentes. Para mapear os atributos adicionais ao esquema da Miro, você pode usar as informações deste documento e seguir os passos abaixo.

⚠️ Como os atributos em nível de aplicativo da Miro são sincronizados em termos de valor com os atributos gerais que você tem no Okta, alguns atributos que podem ser exclusivos da Miro (ou pelo menos não usados anteriormente em sua instância) precisam primeiro ser criados em Diretório > Editor de perfil > Usuário (padrão) antes de você prosseguir com as instruções abaixo.

Criando atributos para SCIM

⚠️ Observe que os atributos devem ser criados no nível do aplicativo Miro, não no Editor de perfil principal do Diretório.

1. Vá para Aplicativos > abra o Miro > Provisionamento.
2. No Okta, vá para Diretório > Editor de perfil > role a página e clique em Ir para o Editor de perfil > clique em Adicionar atributo.
   
   A seção Editor de perfil do aplicativo Miro
   
3. Consulte a lista de atributos suportados e copie o namespace do atributo Miro (a segunda coluna) do atributo que você deseja adicionar. Cole o valor copiado no campo Namespace externo.
4. Copie o atributo Miro correspondente e cole-o no campo Nome da variável. O Okta adicionará automaticamente esse valor também ao Nome externo. Em seguida, remova o ponto do campo Nome da variável caso ele esteja presente.
5. Insira o nome do atributo de sua escolha no campo Nome de exibição (recomendamos usar os valores sugeridos na coluna Nome do atributo IDP em nossa documentação).
6. Marque a caixa Dados pessoais do usuário na parte inferior do modal.

⚠️ Para atributos complexos, como Função do usuário (roles) e Foto do perfil (photos), não mantenha o Nome externo preenchido automaticamente. Defina o Nome externo para a expressão do Okta da tabela de atributos SCIM (por exemplo, roles.^[primary==true].value). Não use o caminho de filtro PATCH do SCIM (roles[primary eq true].value) — o Okta pode remover .value e enviar JSON inválido.

Como resultado, o formulário preenchido deve se parecer com isto:

Adicionando o atributo Nome do gerente no Okta

Exemplo: Admin da empresa (roles)

Use estes valores ao adicionar o atributo de admin da empresa / função do usuário:

• Nome de exibição: Admin da empresa
• Nome da variável: miro_company_admin
• Nome externo: roles.^[primary==true].value
• Namespace externo: urn:ietf:params:scim:schemas:core:2.0:User
• Tipo de atributo: Pessoal (marque a caixa Dados pessoais do usuário)

Valores de função suportados: ORGANIZATION_INTERNAL_ADMIN, ORGANIZATION_INTERNAL_USER.

Clique em Salvar. Verifique se o novo atributo aparece na lista na mesma página. Agora seu atributo está criado, mas não está sincronizado com nada e está vazio.

Configurando mapeamentos

Seu novo atributo está não mapeado e, por padrão, oculto na lista de atributos na guia Provisionamento do aplicativo Miro. Clique em Mostrar atributos não mapeados > Editar seu atributo:

• Valor do atributo: selecione um tipo = Mapear do Perfil do Okta, NOME_DO_ATRIBUTO | string
• selecione Criar e atualizar:

Clique em Salvar. Agora seu atributo aparece como Mapeado na lista, mas esse mapeamento é o que sincroniza os dados no lado do Okta (agora o Okta sabe de onde obter o valor para o atributo). Agora você precisa sincronizar os dados entre a Miro e o Okta.

Clique no botão Mapeamentos na mesma página:

A seção Editor de perfil do aplicativo Miro

Clique na seção Okta User to Miro. À direita, você verá o atributo. À esquerda, escolha o atributo do Okta que deseja sincronizar e defina a conexão para Aplicar mapeamento na criação e atualização do usuário.

Mapeando o atributo Nome do gerente para a Miro

Depois disso, o atributo começará a ser enviado para a Miro para todos os usuários novos e existentes.

Clique em Salvar mapeamentos e depois em Aplicar atualizações agora.

E pronto!

⚠️ Observe que os dados do atributo serão exibidos apenas para os usuários que tiverem qualquer valor de atributo adicionado aos seus perfis.
Para atribuir o atributo em nível de grupo, siga as instruções aqui a partir da p.2.3 (o guia foi criado para atribuição de licença, mas pode ser usado para qualquer atributo).

Os novos atributos começam a ser exibidos na Miro imediatamente (assim que enviados pelo Okta). Os atributos são exibidos nas configurações da Miro para admins na parte inferior do cartão de informações do usuário.

Cartão de informações do usuário

Criando o atributo Foto do perfil para o logon único

Como configurar o Foto do perfil para o fluxo de logon único (quando o SCIM estiver desabilitado)

Se você ativar o SCIM, recomenda-se pular esta parte e configurar o atributo Foto do perfil da forma padrão. Esta parte pode ser usada como uma solução alternativa se você usar apenas o logon único (SSO).

O atributo Foto do perfil, ao contrário de outros, também pode ser transferido durante a autenticação SSO — se você ativá-lo nas configurações de logon único da Miro — não durante pushes SCIM. Por isso, seu fluxo de criação pode ser diferente e, apesar do aviso no início deste artigo, neste caso ele deve ser criado no Editor de perfil principal.

1. Vá para Diretório > Editor de perfil > Adicionar atributo
2. Defina o Nome de exibição como "Foto do perfil"
3. Defina o Nome da variável como "profilePhotoUrl"
   
   O resultado deve ser este:Adicionando o atributo Foto do perfil no Editor de perfil principal do Okta
4. Clique em Salvar e proceda para preencher o atributo personalizado do usuário Foto do perfil para cada usuário no Okta (no Perfil do usuário) usando a URL da imagem como valor.

⚠️ Atualmente o Okta não oferece suporte a armazenar imagens nativamente em sua plataforma. As imagens devem ser hospedadas em um servidor de terceiros, acessível publicamente por URL.
Não há limite de tamanho para as imagens, contudo, imagens maiores que 400x400px podem demorar mais para carregar após o usuário reautenticar.

✏️ Alternativamente, você pode preencher/atualizar o atributo via API do Okta.

Ativando o atributo Foto do perfil

Por fim, ative o atributo na seção Logon do aplicativo Miro.

1. Vá para Aplicativos > escolha seu aplicativo Miro > guia Logon > clique em Editar
   
   Seção Logon do aplicativo Miro**
   
2. Clique na seta ao lado de Atributos (opcional) e adicione os seguintes valores:
   
   • Nome: "ProfilePicture"
     
   • Valor: "user.ProfilePhotoUrl"
     O seu resultado deve ficar assim: 
     
     Ativando o atributo Foto do perfil na seção Logon do aplicativo Miro
3. Verifique duas vezes se a nomenclatura do atributo está igual em todos os locais (recomendamos copiar todos os valores das nossas instruções), caso contrário o Okta pode não conseguir sincronizar.
4. Role a página para baixo e clique em Salvar.

Foto do perfil é exibida após a nova autenticação bem-sucedida do usuário via SSO no lado da Miro.