Este artigo explica como adicionar novos atributos quando sua comunicação da Miro-Okta para o SCIM e ou o SSO já estiver configurada com sucesso.
Como configurar o SSO OktaComo
configurar o guia de provisionamento de licenças do Okta SCIM
Okta para FLP (como criar e atribuir o atributo de
licença)Como configurar o ProfilePicture para o guia de fluxo de SSO (quando o SCIM está desabilitado)
O único valor exigido pela Miro é Nome de usuário, e o atributo deve estar na forma de um e-mail. Outros atributos não são necessários, mas alguns deles serão aceitos pela Miro se presentes. Para mapear os atributos adicionais para o esquema da Miro, você pode usar os detalhes deste documento e seguir as etapas abaixo.
⚠️ Como os atributos no nível do aplicativo da Miro são sincronizados em relação ao 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 na sua instância) precisam primeiro ser criados em Diretório > Editor de perfil > Usuário (padrão) antes de prosseguir para as instruções abaixo.
Como criar atributos para o SCIM
⚠️ Observe que os atributos devem ser criados no nível do aplicativo da Miro, não no editor de perfil principal no diretório.
- Vá para Aplicativos > Abra a Miro > Provisionamento.
- Em OKTA, vá para Diretório > Editor de perfil > role para baixo e clique em Ir para Editor de perfil > clique em Adicionar atributo.A seção Editor de perfil do aplicativo da Miro
- Veja a lista de atributos compatíveis e copie o namespace do atributo da Miro (a segunda coluna) do atributo que você deseja adicionar. Cole o valor copiado no campo Espaço de nome externo.
- Copie o respectivo atributo da Miro e cole-o no campo Nome da variável. A Okta o adicionará automaticamente ao nome externo. Em seguida, remova o sinal de período do campo Nome da variável se ele estiver presente.
- Digite o nome do atributo de sua escolha no campo Nome a exibir (recomendamos usar os valores sugeridos da coluna de nome do atributo IDP em nossa documentação).
- Marque a caixa de seleção pessoal do usuário na parte inferior do modal.
Como resultado, o formulário preenchido deve ser parecido com isto:Como adicionar o atributo nome do gerente no OKTA
Clique em Salvar. Veja que o novo atributo aparece na lista na mesma página. Agora seu atributo foi criado, mas não está sincronizado com nada e está vazio.
Como configurar mapeamentos
Seu novo atributo não está mapeado e por padrão escondido sob o corte na lista de atributos na guia Provisionamento do aplicativo da Miro. Clique para Mostrar atributos não mapeados > Editar seu atributo:
- Valor do atributo: selecione um tipo = mapa do perfil da Okta, ATTRIBUTE_NAME | string
- selecione Criar e atualizar:
Clique para Salvar. Agora seu atributo é mostrado como Mapeado na lista, mas este mapeamento é o único que sincroniza os dados no lado Okta (agora Okta sabe onde tirar o valor do atributo). Agora você precisa sincronizar os dados entre a Miro e a Okta.
Clique no botão Mapeamentos na mesma página:
A seção Editor de perfil do aplicativo da Miro
Clique na seção Usuário para a Miro. À direita, você verá o atributo. À esquerda, escolha o atributo Okta que você deseja sincronizar e defina a conexão como Aplicar mapeamento na criação e atualização do usuário.
Como mapear o atributo de 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 em Aplicar atualizações agora.
E você terminou!
⚠️ Observe que os dados do atributo serão exibidos somente para os usuários que têm qualquer valor de atributo adicionado aos seus perfis.
Para atribuir o atributo no nível do grupo, siga as instruções aqui 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 pela 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
Como criar o atributo de imagem do perfil para SSO
Como configurar o ProfilePicture para o guia de fluxo de SSO (quando o SCIM está desabilitado)
Se você habilitar o SCIM, é recomendado ignorar esta parte e configurar o atributo Imagem do perfil da maneira padrão. Esta parte pode ser usada como uma solução alternativa se você usar somente SSO.
O atributo Imagem do perfil, ao contrário de outros, também pode ser transferido durante a autenticação por SSO, se você habilitá-lo nas configurações de SSO da Miro, não durante os impulsos do SCIM. É por isso que 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.
- Vá para Diretório > Editor de perfil > Adicionar atributo
- Defina o Nome de exibição como "Imagem do perfil".
- Defina o nome da variável como
"profilePhotoUrl"O resultado deve ser o seguinte:Como adicionar o atributo de imagem do perfil no editor de perfil principal da Okta - Clique em Salvar e continue para preencher o atributo personalizado do usuário Imagem do perfil para cada usuário no Okta (no perfil do usuário) usando o URL da imagem como valor.
⚠️ A partir de agora, a Okta não oferece suporte para armazenar imagens nativamente na plataforma. As imagens devem estar hospedadas em um servidor de terceiros, acessível publicamente por
URL.Não há limite de tamanho para imagens, no entanto, as maiores do que 400x400px podem levar tempo adicional para carregar após a reautenticação do usuário.
✏️ Como alternativa, você pode popular/atualizar o atributo por meio da API do Okta.
Como habilitar o atributo de imagem do perfil
Por fim, habilite o atributo na seção Fazer login do aplicativo da Miro.
- Vá para Aplicativos > escolha seu aplicativo da Miro > guia Fazer login > clique para EditarLogon da seção do aplicativo da Miro
- Clique na seta ao lado de Atributos (Opcional) e adicione os seguintes
valores:— Nome:
"ProfilePicture"- Valor:
"user.ProfilePhotoUrl"Seu resultado deve ser parecido com isto: Como habilitar o atributo de Imagem do perfil na seção Fazer login do aplicativo da Miro - Verifique duas vezes se a nomenclatura do atributo é a mesma em todos os lugares (recomendamos copiar todos os valores de nossas instruções), caso contrário, o Okta pode não conseguir sincronizar.
- Role para baixo e clique em Salvar.
A imagem do perfil é exibida após a autenticação de um novo usuário bem-sucedido com SSO no lado da Miro.