Jak zintegrować aplikację Alohi SSO z Azure (Microsoft Entra ID)?

Aby włączyć funkcję logowania jednokrotnego (SSO) dla aplikacji Alohi, Fax.Plus lub Sign.Plus, za pomocą Microsoft Entra ID i zapewnić członkom zespołu bezpośredni dostęp do Fax.Plus lub Sign.Plus z panelu Entra ID, niezbędne są uprawnienia administracyjne w Fax.Plus/Sign.Plus i w Microsoft Azure.

Krok 1:  Dodaj aplikację Alohi w Microsoft Entra ID

1. Zaloguj się do portalu Azure i otwórz Microsoft Entra ID. 
2. Kliknij + Dodaj > Aplikacja dla przedsiębiorstw (lub przejdź do Aplikacje dla przedsiębiorstw > Nowa aplikacja). 
3. W galerii aplikacji Microsoft Entra wyszukaj Alohi i wybierz aplikację Alohi opublikowaną przez Alohi. Upewnij się, że wybrano aplikację o nazwie „Alohi” - obsługuje ona logowanie oparte na SAML oraz automatyczne provisionowanie dla Fax.Plus i Sign.Plus. 
4. Kliknij Utwórz i chwilę zaczekaj, aż aplikacja zostanie dodana do Twojego katalogu.

Krok 2: Skonfiguruj logowanie SAML w Entra ID

1. W aplikacji Alohi przejdź do Zarządzaj > Logowanie jednokrotne i wybierz SAML jako metodę logowania.

2. Entra ID poprosi o zapisanie stałych ustawień logowania Alohi:

   • Identyfikator (Entity ID): https://sso.alohi.com/metadata
   • Adres URL odpowiedzi (Assertion Consumer Service URL): https://sso.alohi.com/login

   Kliknij Tak, aby je zapisać. Te wartości są wstępnie skonfigurowane dla aplikacji Alohi, więc nie trzeba ich wprowadzać ręcznie.
   

3. Na stronie logowania oparte na SAML zbierz dane potrzebne po stronie Fax.Plus/Sign.Plus:
   • W sekcji Certyfikaty SAML, przy opcji Certyfikat (Base64), kliknij Pobierz. Otwórz pobrany plik .cer w edytorze tekstu (TextEdit na Mac, Notatnik na Windows) i przygotuj go do skopiowania. 
   • W sekcji Konfiguracja Alohi skopiuj Adres URL logowania oraz Identyfikator Microsoft Entra.

Krok 3: Aktywuj SSO w Fax.Plus lub Sign.Plus

1. Zaloguj się na swoje konto Fax.Plus i przejdź do Ustawienia > Bezpieczeństwo. 
2. W polu Zarządzanie dostępem, przy opcji Logowanie jednokrotne (SSO), kliknij Aktywuj.
3. Po prawej stronie opcji Logowanie jednokrotne (SSO) kliknij Aktywuj.
4. W kroku Dostawca tożsamości (SAML) wprowadź dane z Entra ID:
   • Adres URL logowania jednokrotnego: wklej Adres URL logowania z kroku 2.
   • Entity ID: wklej Identyfikator Microsoft Entra z kroku 2.
   • Certyfikat X.509: wklej całą treść pliku certyfikatu Base64 otwartego w edytorze tekstu.
   • Czas życia tokenu odświeżania (w sekundach): pozostaw wartość domyślną (3600), o ile Twoja polityka bezpieczeństwa nie wymaga innej wartości. 
   • SSO Bypass: pozostaw zaznaczoną opcję „Zezwól na logowanie za pomocą adresu e-mail i hasła”, jeśli chcesz, aby członkowie mogli logować się przy użyciu hasła jako opcji zapasowej.
5. Wybierz „Alohi SSO” jako typ SSO
6. Na końcu kliknij Dalej

Krok 4: Skonfiguruj automatyczny provisioning użytkowników

1. Krok User Provisioning (SCIM) pokazuje dwie wartości, które będą potrzebne w Entra ID – przygotuj je do skopiowania:
   • Tenant URL: https://sso.alohi.com/scim/v2 
   • SCIM Token
2. W sekcji Product Assignment zaznacz Automatically add new users to Fax.Plus i/lub Automatically add new users to Sign.Plus, aby użytkownicy przypisani w Entra ID byli tworzeni automatycznie. Jeśli wybrano Sign.Plus, na Twoim planie muszą być dostępne wolne miejsca.
   
3. Kliknij Done. Single Sign-On będzie teraz wyświetlane jako Active w ustawieniach Bezpieczeństwo.
4. Wróć do portalu Entra ID, otwórz aplikację Alohi i przejdź do Manage > Provisioning, a następnie kliknij + New configuration.
   
5. Wybierz Get Started i ustaw tryb na Automatic.
   
   
6. W sekcji Admin credentials:
   • Tenant URL: wklej https://sso.alohi.com/scim/v2
   • Secret token: wklej SCIM Token z panelu Fax.Plus.
7. Kliknij Test connection, aby zweryfikować konfigurację, a następnie kliknij Create.

Krok 5: Przypisz użytkowników

1. W aplikacji Alohi w Entra ID przejdź do Manage > Users and groups. 
   
2. Kliknij Add user/group i wybierz osoby, które powinny mieć dostęp. Przypisani użytkownicy zostaną utworzeni automatycznie w Fax.Plus lub Sign.Plus w ramach provisioningu. 
   
3. Mogą teraz zalogować się na swoje konto za pomocą integracji Alohi SSO.

Jak logują się członkowie zespołu

1. Na stronie logowania Fax.Plus członkowie zespołu wpisują swój adres e-mail i klikają Zaloguj się.
   
2. To, co dzieje się dalej, zależy od ustawienia SSO Bypass:
   • SSO Bypass wyłączone: użytkownicy są przekierowywani bezpośrednio do Microsoft Entra ID w celu uwierzytelnienia. Po zalogowaniu trafiają od razu na swoje konto. Logowanie hasłem nie jest dostępne.
   • SSO Bypass włączone: po wpisaniu adresu e-mail użytkownicy widzą ekran z dwiema opcjami: SSO Login i Password. 
     • Wybranie SSO Login kontynuuje logowanie przez dostawcę tożsamości, jak opisano powyżej.
     • Wybranie Use Password pozwala zalogować się za pomocą adresu e-mail i hasła w zwykły sposób.

Aktualizacja informacji o użytkownikach (wkrótce)

Jeśli coś się zmieni po Twojej stronie (adres e-mail, domena lub nazwa użytkownika), zmianę należy wprowadzić po stronie Azure. Upewnij się, że posiadasz odpowiednie uprawnienia do wprowadzenia tej zmiany.
Azure automatycznie zsynchronizuje aktualizację, jednak może to potrwać do 40 minut. Jeśli aktualizacja ma zostać zastosowana szybciej, skorzystaj z opcji on-demand provisioning.

Film instruktażowy