Jak dodać nowe atrybuty w Okta

W tym artykule wyjaśniamy, jak dodać nowe atrybuty, gdy komunikacja Miro z Okta dla SCIM i/lub SSO jest już poprawnie skonfigurowana.

Jak skonfigurować Okta SSO
Jak skonfigurować Okta SCIM
Okta license provisioning Guide for FLP (jak utworzyć i przypisać atrybut licencji)
Jak skonfigurować ProfilePicture dla przepływu SSO (gdy SCIM jest wyłączony)

Jedyną wartością wymaganą przez Miro jest userName i atrybut musi mieć formę adresu e-mail. Pozostałe atrybuty nie są wymagane, ale Miro zaakceptuje niektóre z nich, jeśli będą obecne. Aby zmapować dodatkowe atrybuty do schematu Miro, możesz skorzystać ze szczegółów z tego dokumentu i postępować według poniższych kroków.

⚠️ Ponieważ atrybuty na poziomie aplikacji Miro są synchronizowane wartościowo z ogólnymi atrybutami, które masz w Okta, niektóre atrybuty, które mogą być unikalne dla Miro (lub przynajmniej wcześniej nieużywane w Twojej instancji), trzeba najpierw utworzyć w Katalog > Edytor profilu > Użytkownik (domyślny), zanim przejdziesz do poniższych instrukcji.

Tworzenie atrybutów dla SCIM

⚠️ Zwróć uwagę, że atrybuty muszą być tworzone na poziomie aplikacji Miro, nie w głównym Edytorze profilu w Katalogu.

1. Przejdź do Aplikacje > otwórz aplikację Miro > Obsługa administracyjna.
2. W Okta przejdź do Katalog > Edytor profilu > przewiń w dół i kliknij Przejdź do Edytora profilu > kliknij Dodaj atrybut.
   
   Sekcja Edytor profilu aplikacji Miro
   
3. Sprawdź listę obsługiwanych atrybutów i skopiuj przestrzeń nazw atrybutu Miro (druga kolumna) atrybutu, który chcesz dodać. Wklej skopiowaną wartość do pola Zewnętrzna przestrzeń nazw.
4. Skopiuj odpowiedni atrybut Miro i wklej go w pole Nazwa zmiennej. Okta automatycznie doda go także do Zewnętrzna nazwa. Następnie usuń znak kropki z pola Nazwa zmiennej, jeśli się tam znajduje.
5. Wpisz wybraną nazwę atrybutu w polu Nazwa wyświetlana (zalecamy użycie sugerowanych wartości z kolumny IDP attribute name w naszej dokumentacji).
6. Zaznacz pole wyboru Dane osobiste użytkownika u dołu okna modalnego.

⚠️ Dla złożonych atrybutów, takich jak Rola użytkownika (roles) i Zdjęcie profilowe (photos), nie pozostawiaj automatycznie wypełnionej Zewnętrznej nazwy. Ustaw Zewnętrzną nazwę na wyrażenie Okta z tabeli atrybutów SCIM (na przykład roles.^[primary==true].value). Nie używaj filtra ścieżki SCIM PATCH (roles[primary eq true].value) — Okta może usunąć .value i wysłać nieprawidłowy JSON.

W efekcie wypełniony formularz powinien wyglądać mniej więcej tak:

Dodawanie atrybutu Nazwa przełożonego w Okta

Przykład: Administrator firmy (roles)

Użyj tych wartości przy dodawaniu atrybutu roli administratora firmy / użytkownika:

• Nazwa wyświetlana: Company Admin
• Nazwa zmiennej: miro_company_admin
• Zewnętrzna nazwa: roles.^[primary==true].value
• Zewnętrzna przestrzeń nazw: urn:ietf:params:scim:schemas:core:2.0:User
• Typ atrybutu: Osobiste (zaznacz pole wyboru Dane osobiste użytkownika)

Obsługiwane wartości ról: ORGANIZATION_INTERNAL_ADMIN, ORGANIZATION_INTERNAL_USER.

Kliknij Zapisz. Sprawdź, czy nowy atrybut pojawił się na liście na tej samej stronie. Teraz atrybut jest utworzony, ale nie jest zsynchronizowany z niczym i jest pusty.

Konfigurowanie mapowań

Twój nowy atrybut jest niezmapowany i domyślnie ukryty na liście atrybutów na karcie Obsługa administracyjna aplikacji Miro. Kliknij, aby Pokaż niezamapowane atrybuty > Edytuj swój atrybut:

• Wartość atrybutu: wybierz typ = Mapuj z profilu Okta, ATTRIBUTE_NAME | string
• wybierz Utwórz i aktualizuj:

Kliknij Zapisz. Teraz Twój atrybut jest widoczny jako Zamapowany na liście, ale to mapowanie odpowiada za synchronizację po stronie Okta (Okta wie, skąd pobrać wartość atrybutu). Teraz musisz zsynchronizować dane między Miro i Okta.

Kliknij przycisk Mapowania na tej samej stronie:

Sekcja Edytor profilu aplikacji Miro

Kliknij sekcję Okta User to Miro. Po prawej zobaczysz atrybut. Po lewej wybierz atrybut Okta, który chcesz zsynchronizować, a następnie ustaw połączenie na Zastosuj mapowanie przy tworzeniu i aktualizacji użytkownika.

Mapowanie atrybutu Nazwa przełożonego do Miro

Po tym atrybut zacznie być wysyłany do Miro dla wszystkich nowych i istniejących użytkowników.

Kliknij Zapisz mapowania, a następnie Zastosuj aktualizacje teraz.

I gotowe!

⚠️ Zwróć uwagę, że dane atrybutu będą wyświetlane tylko dla tych użytkowników, którzy mają jakąkolwiek wartość atrybutu dodaną do swoich profili.
Aby przypisać atrybut na poziomie grupy, postępuj zgodnie z instrukcjami tutaj od p.2.3 (przewodnik jest stworzony dla przypisywania licencji, ale można go użyć dla dowolnego atrybutu).

Nowe atrybuty zaczynają wyświetlać się w Miro natychmiast (zaraz po wysłaniu ich przez Okta). Atrybuty wyświetlają się w ustawieniach Miro dla administratorów na dole karty informacji o użytkowniku.

Karta informacji o użytkowniku

Tworzenie atrybutu Zdjęcie profilowe dla SSO

Jak skonfigurować ProfilePicture dla przepływu SSO (gdy SCIM jest wyłączony)

Jeśli włączysz SCIM, zalecamy pominąć tę część i skonfigurować atrybut Zdjęcie profilowe w standardowy sposób. Ten fragment można wykorzystać jako obejście, jeśli używasz tylko SSO.

Atrybut Zdjęcie profilowe, w odróżnieniu od innych, może być też przekazywany podczas uwierzytelniania SSO — jeśli włączysz go w ustawieniach SSO Miro — a nie podczas pushy SCIM. Dlatego jego przebieg tworzenia może się różnić i pomimo uwagi na początku tego artykułu, w tym przypadku powinien być on utworzony w głównym Edytorze profilu.

1. Przejdź do Katalog > Edytor profilu > Dodaj atrybut
2. Ustaw Nazwę wyświetlaną jako "Profile Picture"
3. Ustaw Nazwę zmiennej jako "profilePhotoUrl"
   
   Wynik powinien wyglądać tak:Dodawanie atrybutu Profile Picture w głównym Edytorze profilu Okta
4. Kliknij Zapisz i przejdź do uzupełnienia niestandardowego atrybutu użytkownika Profile Picture dla każdego użytkownika w Okta (w profilu użytkownika) używając adresu URL obrazu jako wartości.

⚠️ Obecnie Okta nie obsługuje przechowywania obrazów natywnie w swojej platformie. Obrazy muszą być hostowane na serwerze zewnętrznym i dostępne publicznie przez URL.
Nie ma ograniczenia rozmiaru obrazów, jednak obrazy większe niż 400x400 px mogą potrzebować dodatkowego czasu na załadowanie po ponownym uwierzytelnieniu użytkownika.

✏️ Alternatywnie możesz uzupełnić/aktualizować atrybut przez API Okta.

Włączenie atrybutu Zdjęcie profilowe

Na koniec włącz atrybut w sekcji Logowanie aplikacji Miro.

1. Przejdź do Aplikacje > wybierz swoją aplikację Miro > karta Logowanie > kliknij Edytuj
   
   Sekcja Logowanie aplikacji Miro**
   
2. Kliknij strzałkę obok Atrybuty (opcjonalne) i dodaj następujące wartości:
   
   • Nazwa: "ProfilePicture"
     
   • Wartość: "user.ProfilePhotoUrl"
     Twój wynik powinien wyglądać tak: 
     
     Włączanie atrybutu Zdjęcie profilowe w sekcji Logowanie aplikacji Miro
3. Sprawdź dwukrotnie, czy nazewnictwo atrybutu jest takie samo wszędzie (zalecamy kopiowanie wszystkich wartości z naszych instrukcji), w przeciwnym razie Okta może nie być w stanie zsynchronizować.
4. Przewiń w dół i kliknij Zapisz.

Zdjęcie profilowe jest wyświetlane po pomyślnym, nowym uwierzytelnieniu użytkownika przez SSO po stronie Miro.