Automatyczny import kontaktów Entra ID (Active Directory) do cyfrowych wizytówek

W tym artykule dowiesz się, jak importować kontakty z Microsoft Entra ID (Active Directory) i tworzyć dla nich masowo cyfrowe wizytówki

Ten post zawiera szczegóły techniczne dla działu IT zarządzającego Microsoft Azure Entra ID (Active Directory). Skontaktuj się z ekspertem IT, który pomoże Ci skonfigurować wszystko. Upewnij się, że osoba wykonująca konfigurację na Microsoft Azure ma niezbędne uprawnienia administratora.

Aby zintegrować Microsoft Azure Active Directory/Entra ID z naszą platformą kodów QR, używamy konektora do wymiany informacji między Twoim systemem a naszym. Potrzebujemy tylko kilku poświadczeń dostępu, aby móc pobrać potrzebne dane z Twojego Entra ID.

Aby skonfigurować Active Directory/Entra ID należy wykonać 2 kroki. Po pierwsze, utworzyć aplikację korporacyjną, a po drugie udzielić uprawnień API dla tej aplikacji korporacyjnej. Zacznijmy od pierwszego kroku.

Aby połączyć naszą Platformę QR Code z Active Directory/Entra ID należy utworzyć tak zwaną Aplikację Enterprise. Ta Aplikacja Enterprise jest reprezentacją naszej Platformy QR Code na koncie Microsoft Azure.

Najpierw upewnij się, że jesteś zalogowany na swoje konto Microsoft Azure. Dostęp do portalu Microsoft Azure można uzyskać za pośrednictwem portal.azure.com.

Następnie otwórz usługę Entra ID Service. Usługę można znaleźć za pomocą paska wyszukiwania, wpisując "Microsoft Entra ID"

W usłudze Microsoft Entra ID kliknij menu Enterprise Applications w sekcji Manage (po lewej stronie).

Aby utworzyć nową aplikację korporacyjną kliknij na Nowa aplikacja.

Kliknij na Stwórz własną aplikację.

Wprowadź nazwę (w naszym przykładzie użyjemy QR Code Platform) dla aplikacji i wybierz opcję 3 (Non-gallery). Następnie kliknij na Create.

Teraz musimy przejść do przeglądu aplikacji. Aby się tam dostać, musimy ponownie wejść do Entra ID Service.

Kliknij w prawym górnym rogu ekranu na Home lub na Microsoft Azure - oba powinny działać. Wylądujesz na stronie głównej Azure.

Teraz ponownie otwórz usługę Entra ID. Usługę można znaleźć, wyszukując ją w pasku wyszukiwania, wpisując "Microsoft Entra ID".

W lewym menu Entra ID otwórz podmenu Manage, a następnie wybierz App registrations. Następnie kliknij nad listą na Wszystkie aplikacje, a następnie wybierz z listy aplikację, którą właśnie utworzyłeś - w naszym przypadku jest to QR Code Platform.

W obszarze Overview nowej aplikacji skopiuj identyfikator Application (client) ID i wklej go do dokumentu Word, a następnie zaznacz, że jest to identyfikator klienta, po czym kliknij Add Client credentials.

Kliknij na Nowy sekret klienta.

Wprowadź Opis sekretu klienta, na przykład Cyfrowa wizytówka i kliknij przycisk Dodaj. Wybierz datę wygaśnięcia sekretu w zależności od tego, czy i kiedy chcesz ponownie użyć funkcji automatycznego importu w przyszłości - domyślnie jest to 180 dni. Jeśli potrzebujesz go tylko dzisiaj, możesz wybrać krótsze ramy czasowe.

Skopiuj kod z kolumny Value (NIE z kolumny Secret ID) do dokumentu Word i napisz Client Secret Value obok niego, aby później wiedzieć, która to wartość. Będziemy ich potrzebować później

Teraz nadszedł czas, aby nadać uprawnienia API naszej właśnie utworzonej aplikacji. W lewym menu bocznym kliknij na menu Uprawnienia API, a następnie na Dodaj uprawnienie.

Następnie wybierz Microsoft Graph z typem Uprawnienia aplikacji i na ekranie wyszukaj i dodaj następujące uprawnienia: User.Read.All i Directory.Read.All. Upewnij się, że uprawnienie jest zaznaczone na liście.

Teraz konieczne jest, aby użytkownik z uprawnieniami administratora udzielił zgody, klikając przycisk Udziel zgody administratora dla swojej firmy.

Teraz Entra ID jest gotowa do pobrania danych.

Teraz nadszedł czas, aby przełączyć się na Platformę QR Code, aby zaimportować kontakty i automatycznie wygenerować dla nich cyfrowe wizytówki. Wejdź na naszą stronę i zaloguj się do Platformy QR Code .

Po zalogowaniu przejdź do Import i wybierz Importuj kontakty.

Na następnym ekranie wybierz Entra ID Import.

Następnie czas wprowadzić Client ID i Client Secret. Użyj skopiowanych wcześniej wartości. Dla identyfikatora klienta użyj wartości z "Application (client) ID", a dla sekretu klienta użyj wartości z kolumny "Value", którą wcześniej zapisałeś w dokumencie Word jako Client Secret Value.

Przed kliknięciem Connect musisz zdecydować, w jaki sposób chcesz zaimportować kontakty z Entra ID.

Wybierz folder, do którego chcesz zaimportować kontakty. Następnie określ, czy chcesz zaimportować kontakty jako Mobilną wizytówkę czy vCard.

Następnie kliknij przycisk Połącz, aby rozpocząć przetwarzanie.

System najpierw sprawdzi, czy podane dane uwierzytelniające działają, a następnie załaduje kontakty do listy, na której możesz zdecydować, które z nich chcesz faktycznie zaimportować.

Na poniższym ekranie zostaną wyświetlone dostępne kontakty. Skorzystaj z ostatniej kolumny Importuj? i zaznacz pole wyboru obok kontaktów, które chcesz zaimportować, a następnie kliknij przycisk Importuj.

Następnie u góry ekranu pojawi się komunikat o powodzeniu z informacją o tym, ile plików zostało utworzonych, zaktualizowanych lub musiało zostać pominiętych.

Zaimportowane wpisy znajdują się teraz w wybranym folderze. Gratulacje, pomyślnie zaimportowałeś kontakty z Entra ID!