Konfigurowanie programu itsme OpenID Connect (OIDC) przy użyciu usługi Azure Active Directory B2C

Ważne

Od 1 maja 2025 r. usługa Azure AD B2C nie będzie już dostępna do zakupu dla nowych klientów. Dowiedz się więcej w naszych często zadawanych pytaniach.

Aplikacja itsme digital ID umożliwia bezpieczne logowanie bez czytników kart, haseł, uwierzytelniania dwuskładnikowego lub wielu kodów PIN. Aplikacja itsme ma silne uwierzytelnianie klienta z zweryfikowaną tożsamością. W tym artykule dowiesz się, jak zintegrować uwierzytelnianie Azure AD B2C z itsme OIDC przy użyciu zasad przepływu użytkownika z wpisem tajnym klienta.

Wymagania wstępne

Aby rozpocząć pracę, potrzebne są następujące elementy:

  • Subskrypcja platformy Azure. Jeśli go nie masz, możesz uzyskać bezpłatne konto.
  • Dzierżawa usługi Azure AD B2C połączona z subskrypcją platformy Azure.
  • Identyfikator klienta, znany również jako kod partnera, dostarczony przez itsme.
  • Kod usługi dostarczony przez itsme.
  • Twój tajny klucz klienta do konta itsme.

Opis scenariusza

Diagram architektury Itsme

Krok Opis
1 W swojej witrynie internetowej lub aplikacji dodaj przycisk Zaloguj się przez itsme w przepływie użytkownika usługi Azure AD B2C. Przepływ interakcji rozpoczyna się po kliknięciu tego przycisku przez użytkownika.
2 Azure AD B2C rozpoczyna przepływ OIDC, wysyłając żądanie autoryzacji do interfejsu API klucza tajnego klienta itsme. Dostępny jest dobrze znany/otwarty punkt końcowy konfiguracji zawierający informacje o punktach końcowych.
3 Środowisko itsme przekierowuje użytkownika do strony zidentyfikuj siebie, umożliwiając użytkownikowi podanie numeru telefonu.
4 Środowisko itsme odbiera numer telefonu od użytkownika i weryfikuje poprawność.
5 Jeśli numer telefonu należy do aktywnego użytkownika itsme, zostanie utworzona akcja dla aplikacji itsme.
6 Użytkownik otwiera aplikację itsme, sprawdza żądanie i potwierdza akcję.
7 Aplikacja informuje środowisko itsme o potwierdzeniu akcji.
8 Środowisko itsme zwraca kod autoryzacji OAuth do usługi Azure AD B2C.
9 Przy użyciu kodu autoryzacji usługa Azure AD B2C wykonuje żądanie tokenu.
10 Środowisko itsme sprawdza żądanie tokenu, a jeśli nadal jest prawidłowe, zwraca token dostępu OAuth i token identyfikatora zawierający żądane informacje o użytkowniku.
11 Na koniec użytkownik jest przekierowywany do adresu URL przekierowania jako uwierzytelniony użytkownik.

Rozpocznij korzystanie z itsme

  1. Aby utworzyć konto itsme, odwiedź stronę Azure Marketplace.

  2. Aktywuj swoje konto itsme, wysyłając wiadomość e-mail na adres onboarding@itsme.be. Otrzymasz kod partnera i kod usługi dla konfiguracji B2C.

  3. Po aktywacji konta partnera itsme otrzymasz wiadomość e-mail z jednorazowym linkiem do tajemnicy klienta.

  4. Postępuj zgodnie z instrukcjami w pliku itsme , aby ukończyć konfigurację.

Integracja z usługą Azure AD B2C

Konfigurowanie nowego dostawcy tożsamości w usłudze Azure AD B2C

Uwaga / Notatka

Jeśli go nie masz, to utwórz dzierżawę usługi Azure AD B2C połączoną z Twoją subskrypcją platformy Azure.

  1. Jeśli masz dostęp do wielu dzierżaw, wybierz ikonę Ustawienia w górnym menu, aby przełączyć się na dzierżawę Azure AD B2C z menu Katalogi + subskrypcje.

  2. W obszarze Usługi platformy Azure wybierz pozycję Azure AD B2C (lub wybierz pozycję Więcej usług i użyj pola wyszukiwania Wszystkie usługi , aby wyszukać usługę Azure AD B2C).

  3. Wybierz pozycję Dostawcy tożsamości, a następnie wybierz pozycję Nowy dostawca OpenID Connect.

  4. Wypełnij formularz następującymi informacjami:

    Majątek Wartość
    Nazwa itsme
    Adres URL metadanych https://oidc.<environment>.itsme.services/clientsecret-oidc/csapi/v0.1/.well-known/openid-configuration
    gdzie <environment> to e2e (środowisko testowe) lub prd (produkcja)
    ClientID Identyfikator klienta lub kod partnera
    Tajemnica klienta tajny_klucz_klienta
    Scope openid service:YOURSERVICECODE profil e-mail [telefon] [adres]
    Typ odpowiedzi kod
    Tryb odpowiedzi kwerenda
    Wskazówka dotycząca domeny Możesz pozostawić to puste
    Identyfikator użytkownika Subskrypcja
    Wyświetlana nazwa nazwa
    Imię given_name
    Nazwisko nazwisko rodzinne
    Email e-mail
  5. Wybierz Zapisz.

Konfigurowanie przepływu użytkownika

  1. W dzierżawie usługi Azure AD B2C w sekcji Zasady wybierz pozycję Przepływy użytkownika.

  2. Wybierz pozycję Nowy przepływ użytkownika.

  3. Wybierz pozycję Zarejestruj się i zaloguj się, wybierz wersję, a następnie wybierz pozycję Utwórz.

  4. W polu Nazwa wprowadź nazwę.

  5. W sekcji Dostawcy tożsamości wybierz itsme.

  6. Wybierz Utwórz.

  7. Otwórz utworzony przepływ użytkownika, wybierając nazwę przepływu użytkownika.

  8. Wybierz pozycję Właściwości i dostosuj następujące wartości:

    • Zmień okresy istnienia tokenu dostępu i identyfikatora (w minutach) na 5.
    • Zmień okres istnienia okna przewijania tokenu odświeżania na Brak wygaśnięcia.

Rejestrowanie aplikacji

  1. W dzierżawie B2C w obszarze Zarządzanie wybierz pozycję Rejestracje aplikacji>Nowa rejestracja.

  2. Podaj nazwę aplikacji i wprowadź identyfikator URI przekierowania. W celach testowych wprowadź https://jwt.ms.

  3. Upewnij się, że uwierzytelnianie wieloskładnikowe jest wyłączone.

  4. Wybierz pozycję Zarejestruj.

Aby przetestować przepływ użytkownika przy użyciu tej rejestracji aplikacji, należy włączyć niejawny przepływ udzielania:

  1. Wybierz utworzoną rejestrację aplikacji.

  2. W obszarze Zarządzanie wybierz pozycję Uwierzytelnianie.

  3. W sekcji Niejawne przyznanie i przepływy hybrydowe zaznacz oba pola wyboru Tokeny dostępu (używane w przepływach niejawnych) i Tokeny identyfikacyjne (używane w przepływach niejawnych i hybrydowych).

  4. Wybierz Zapisz.

Uwaga / Notatka

Jeśli włączysz niejawne udzielanie w celu przetestowania przepływu użytkownika, wyłącz niejawne ustawienia przepływu udzielania przed wdrożeniem aplikacji w środowisku produkcyjnym.

Testowanie przepływu użytkownika

  1. W dzierżawie B2C, w sekcji Zasady, wybierz pozycję Przepływy użytkownika.

  2. Wybierz utworzony wcześniej przepływ użytkownika.

  3. Wybierz Uruchom przepływ użytkownika.

    a. W polu Aplikacja wybierz zarejestrowaną aplikację.

    b. W polu Adres URL odpowiedzi wybierz adres URL przekierowania dodany do aplikacji. W celach testowych wybierz pozycję https://jwt.ms.

  4. Zostanie wyświetlona strona itsme Identify yourself (Zidentyfikuj siebie ).

  5. Wprowadź numer telefonu komórkowego i wybierz pozycję Wyślij.

  6. Potwierdź akcję w aplikacji itsme.

Dalsze kroki

Aby uzyskać więcej informacji, zobacz następujące artykuły: