Zdarzenia
9 kwi, 15 - 10 kwi, 12
Zakoduj przyszłość za pomocą sztucznej inteligencji i połącz się z elementami równorzędnymi i ekspertami języka Java w witrynie JDConf 2025.
Zarejestruj się terazTa przeglądarka nie jest już obsługiwana.
Przejdź na przeglądarkę Microsoft Edge, aby korzystać z najnowszych funkcji, aktualizacji zabezpieczeń i pomocy technicznej.
Poniższa dokumentacja zawiera informacje o ogólnym łączniku usług internetowych. Zarządzanie tożsamością Microsoft Entra obsługuje aprowizowanie kont w różnych aplikacjach, takich jak SAP ECC, Oracle eBusiness Suite i aplikacje biznesowe, które uwidaczniają interfejsy API REST lub SOAP. Klienci, którzy wcześniej wdrożyli program MIM w celu nawiązania połączenia z tymi aplikacjami, mogą łatwo przełączyć się na korzystanie z uproszczonego agenta aprowizacji firmy Microsoft, a jednocześnie ponownie używać tego samego łącznika usług internetowych skompilowanego dla programu MIM.
Łącznik usług internetowych implementuje następujące funkcje:
Odnajdywanie protokołu SOAP: umożliwia administratorowi wprowadzenie ścieżki WSDL uwidocznionej przez docelową usługę internetową. Odnajdywanie tworzy strukturę drzewa hostowanych usług internetowych aplikacji wraz z wewnętrznymi punktami końcowymi lub operacjami wraz z opisem metadanych operacji. Nie ma limitu liczby operacji odnajdywania, które można wykonać (krok po kroku). Odnalezione operacje są później używane do konfigurowania przepływu operacji implementujących operacje łącznika względem źródła danych (jako Import/Export).
Odnajdywanie REST: umożliwia administratorowi wprowadzanie szczegółów usługi REST, w tym punkt końcowy usługi, ścieżka zasobu, metoda i szczegóły parametru. Informacje o usługach REST są przechowywane w pliku discovery.xml
projektu wsconfig
. Będą one używane później przez administratora w celu skonfigurowania działania usługi internetowej REST w przepływie pracy.
Konfiguracja schematu: umożliwia administratorowi skonfigurowanie schematu. Konfiguracja schematu zawiera listę typów obiektów i atrybutów dla określonej aplikacji. Administrator może wybrać atrybuty, które mają być częścią schematu.
Konfiguracja przepływu operacji: interfejs użytkownika projektanta przepływu pracy do konfigurowania implementacji operacji importu i eksportu na typ obiektu za pomocą uwidocznionych funkcji operacji usługi internetowej, w tym przypisania parametrów od użytkownika aprowizowanego do funkcji usługi internetowej.
Komputer z uruchomionym agentem aprowizacji powinien mieć:
Przed skonfigurowaniem aprowizacji upewnij się, że:
Dzierżawa firmy Microsoft Entra z identyfikatorem Microsoft Entra ID P1 lub Premium P2 (lub EMS E3 lub E5).
Korzystanie z tej funkcji wymaga licencji microsoft Entra ID P1. Aby znaleźć licencję odpowiednią do wymagań, zobacz porównanie ogólnodostępnych funkcji usługi Microsoft Entra ID.
Rola administratora tożsamości hybrydowej do konfigurowania agenta aprowizacji oraz ról administratora aplikacji lub administratora aplikacji w chmurze na potrzeby konfigurowania aprowizacji w witrynie Azure Portal.
Użytkownicy firmy Microsoft Entra, którzy mają być aprowizowani w aplikacji, muszą mieć już przypisane wszystkie atrybuty wymagane przez aplikację.
W obszarze Łączność lokalna wybierz pozycję Pobierz i zainstaluj, a następnie wybierz pozycję Akceptuj warunki i pobierz.
Pozostaw portal i uruchom instalatora agenta aprowizacji, zaakceptuj warunki świadczenia usługi, a następnie wybierz pozycję Zainstaluj.
Poczekaj na kreatora konfiguracji agenta aprowizacji firmy Microsoft, a następnie wybierz przycisk Dalej.
W kroku Wybierz rozszerzenie wybierz pozycję Aprowizowanie aplikacji lokalnych, a następnie wybierz pozycję Dalej.
Agent aprowizacji używa przeglądarki internetowej systemu operacyjnego do wyświetlania okna wyskakującego służącego do uwierzytelnienia w usłudze Microsoft Entra ID, a potencjalnie także u dostawcy tożsamości organizacji. Jeśli używasz programu Internet Explorer jako przeglądarki w systemie Windows Server, może być konieczne dodanie witryn internetowych firmy Microsoft do listy zaufanych witryn przeglądarki, aby umożliwić poprawne uruchamianie języka JavaScript.
Po wyświetleniu monitu o autoryzację podaj poświadczenia administratora firmy Microsoft Entra. Użytkownik musi mieć co najmniej rolę administratora tożsamości hybrydowej.
Wybierz pozycję Potwierdź , aby potwierdzić ustawienie. Po pomyślnym zakończeniu instalacji możesz wybrać pozycję Zakończ, a także zamknąć instalatora pakietu agenta aprowizacji.
W portalu w sekcji Łączność lokalna wybierz wdrożonego agenta i wybierz pozycję Przypisz agentów.
Pozostaw to okno przeglądarki otwarte po zakończeniu następnego kroku konfiguracji przy użyciu kreatora konfiguracji.
W systemie Windows Server, w którym jest zainstalowany agent aprowizacji, kliknij prawym przyciskiem myszy Kreator konfiguracji Microsoft ECMA2Host z menu Start, i uruchom jako administrator. Uruchomienie jako administrator systemu Windows jest niezbędne do utworzenia niezbędnych dzienników zdarzeń systemu Windows przez kreatora.
Po uruchomieniu konfiguracji hosta łącznika ECMA, jeśli uruchamiasz kreatora po raz pierwszy, zostanie wyświetlony monit o utworzenie certyfikatu. Pozostaw domyślny port 8585 i wybierz pozycję Generuj certyfikat , aby wygenerować certyfikat. Automatycznie wygenerowany certyfikat jest podpisany samodzielnie jako część zaufanego korzenia. Nazwa SAN certyfikatu jest zgodna z nazwą hosta.
Wybierz pozycję Zapisz.
Przed utworzeniem konfiguracji łącznika usług internetowych należy utworzyć szablon łącznika usług internetowych i dostosować go, aby spełniał potrzeby określonego środowiska. Upewnij się, że wartości ServiceName, EndpointName i OperationName są poprawne.
Przykładowe szablony i wskazówki dotyczące sposobu integracji z popularnymi aplikacjami, takimi jak SAP ECC 7.0 i Oracle eBusiness Suite, można znaleźć w pakiecie pobierania łączników. Możesz dowiedzieć się, jak utworzyć nowy projekt dla źródła danych w narzędziu konfiguracji usługi internetowej, korzystając z przewodnika przepływu pracy dla protokołu SOAP.
Aby uzyskać więcej informacji na temat konfigurowania szablonu w celu nawiązania połączenia z interfejsem API REST lub SOAP własnej aplikacji, zobacz Omówienie ogólnego łącznika usługi sieci Web w bibliotece dokumentacji programu MIM.
W tej sekcji utworzysz konfigurację łącznika dla aplikacji.
Aby połączyć agenta aprowizacji firmy Microsoft z aplikacją, wykonaj następujące kroki:
Skopiuj plik szablonu .wsconfig
łącznika usługi internetowej do C:\Program Files\Microsoft ECMA2Host\Service\ECMA
folderu .
Wygeneruj tajny token używany do uwierzytelniania Microsoft Entra ID do łącznika. Minimalna liczba znaków i unikatowa dla każdej aplikacji powinna wynosić 12 znaków.
Jeśli jeszcze tego nie zrobiono, uruchom Kreatora konfiguracji microsoft ECMA2Host z menu Start systemu Windows.
Wybierz pozycję Nowy łącznik.
Na stronie Właściwości wypełnij pola wartościami określonymi w tabeli, która następuje po obrazie, a następnie wybierz pozycję Dalej.
Właściwości | Wartość |
---|---|
Nazwisko | Nazwa wybrana dla łącznika, która powinna być unikatowa dla wszystkich łączników w danym środowisku. |
Czasomierz autosync (minuty) | 120 |
Token tajny | Wprowadź token tajny wygenerowany dla tego łącznika. Klucz powinien mieć minimalną długość 12 znaków. |
Biblioteka DLL rozszerzenia | W przypadku łącznika usług internetowych wybierz pozycję Microsoft.IdentityManagement.MA.WebServices.dll. |
Na stronie Łączność wypełnij pola wartościami określonymi w tabeli, która następuje po obrazie, a następnie wybierz pozycję Dalej.
Właściwości | opis |
---|---|
Projekt usługi sieci Web | Nazwa szablonu usług internetowych. |
Gospodarz | Nazwa hosta punktu końcowego protokołu SOAP aplikacji, taka jak vhcalnplci.dummy.nodomain |
Port | Port punktu końcowego protokołu SOAP aplikacji, taki jak 8000 |
Na stronie Możliwości wypełnij pola wartościami określonymi w poniższej tabeli i wybierz pozycję Dalej.
Właściwości | Wartość |
---|---|
Styl nazwy wyróżniającej | Ogólna |
Typ eksportu | ObjectReplace |
Normalizacja danych | Brak |
Potwierdzenie obiektu | Normalna |
Włącz importowanie | Zaznaczone |
Włączony import różnicowy | Niezaznaczone |
Włącz eksportowanie | Zaznaczone |
Włączanie pełnego eksportu | Niezaznaczone |
Włącz hasło eksportu w pierwszym przebiegu | Zaznaczone |
Brak wartości referencyjnych w pierwszym przebiegu eksportu | Niezaznaczone |
Włączanie zmiany nazwy obiektu | Niezaznaczone |
Usuń dodaj jako zamień | Niezaznaczone |
Uwaga
Jeśli szablon łącznika usług internetowych zostanie otwarty do edycji w narzędziu konfiguracji usługi sieci Web, zostanie wyświetlony błąd.
Na stronie Globalne wypełnij pola i wybierz przycisk Dalej.
Na stronie Partycje wybierz pozycję Dalej.
Na stronie Profile uruchamiania zaznacz pole wyboru Eksportuj. Zaznacz pole wyboru Pełny import i wybierz przycisk Dalej. Profil uruchamiania Eksport jest używany przez hosta łącznika ECMA do wysyłania zmian z Microsoft Entra ID do Twojej aplikacji w celu wstawiania, aktualizowania i usuwania rekordów. Profil uruchamiania pełnego importu jest używany podczas uruchamiania usługi hosta łącznika ECMA, aby odczytać bieżącą zawartość aplikacji.
Właściwości | Wartość |
---|---|
Export | Uruchom profil, który eksportuje dane do aplikacji. Ten profil uruchamiania jest wymagany. |
Pełny import | Uruchom profil, który importuje wszystkie dane z aplikacji. |
Importowanie różnicowe | Uruchom profil, który importuje tylko zmiany z aplikacji od ostatniego pełnego lub częściowego importu. |
Na stronie Typy obiektów wypełnij pola i wybierz przycisk Dalej. Użyj tabeli, która jest zgodna z obrazem, aby uzyskać wskazówki dotyczące poszczególnych pól.
Kotwica : wartości tego atrybutu powinny być unikatowe dla każdego obiektu w systemie docelowym. Usługa aprowizacji Microsoft Entra wysyła zapytanie do hosta łącznika ECMA przy użyciu tego atrybutu po cyklu początkowym. Ta wartość jest zdefiniowana w szablonie łącznika usług internetowych.
DN : w większości przypadków powinna być wybrana opcja Automatycznie wygenerowana. Jeśli nie jest zaznaczona, upewnij się, że atrybut DN jest mapowany na atrybut w identyfikatorze Entra firmy Microsoft, który przechowuje dn w tym formacie: CN = anchorValue, Object = objectType. Aby uzyskać więcej informacji na temat kotwic i dn, zobacz About anchor attributes and distinguished names (Informacje o atrybutach kotwicy i nazwach wyróżniających).
Właściwości | Wartość |
---|---|
Obiekt docelowy | User |
Kotwica | userName |
DN | userName |
Automatycznie wygenerowane | Zaznaczone |
Host łącznika ECMA odnajduje atrybuty obsługiwane przez aplikację. Następnie możesz wybrać, które z odnalezionych atrybutów chcesz uwidocznić w identyfikatorze Entra firmy Microsoft. Te atrybuty można następnie skonfigurować w witrynie Azure Portal na potrzeby aprowizacji. Na stronie Wybierz atrybuty dodaj wszystkie atrybuty na liście rozwijanej pojedynczo. Lista rozwijana Atrybut zawiera wszystkie atrybuty odnalezione w aplikacji i nie zostały wybrane na poprzedniej stronie Wybierz atrybuty . Po dodaniu wszystkich odpowiednich atrybutów wybierz pozycję Dalej.
Na stronie Anulowanie aprowizacji w obszarze Wyłącz przepływ wybierz pozycję Usuń. Atrybuty wybrane na poprzedniej stronie nie będą dostępne do wybrania na stronie Anulowanie aprowizacji. Wybierz Zakończ.
Uwaga
Jeśli używasz wartości ustaw atrybut należy pamiętać, że dozwolone są tylko wartości logiczne.
Na stronie anulowania aprowizacji w obszarze Wyłącz przepływ wybierz pozycję Brak, jeśli będziesz kontrolować stan konta użytkownika z właściwością taką jak expirationTime. Na ekranie zarządzania przepływem wybierz opcję Brak, jeśli nie chcesz usuwać użytkowników z aplikacji, lub Usuń, jeśli chcesz to zrobić. Wybierz Zakończ.
Na serwerze z uruchomionym hostem łącznika Microsoft Entra ECMA wybierz pozycję Uruchom.
Wprowadź polecenie run i wprowadź ciąg services.msc w polu .
Na liście Usługi upewnij się, że host Microsoft ECMA2Host jest obecny i uruchomiony. W przeciwnym razie wybierz pozycję Uruchom.
Jeśli usługa została niedawno uruchomiona i masz wiele obiektów użytkownika w aplikacji, zaczekaj kilka minut na nawiązanie połączenia z aplikacją i przeprowadzenie początkowego pełnego importu.
Wróć do okna przeglądarki internetowej, w którym skonfigurowano aprowizację aplikacji.
Uwaga
Jeśli upłynął limit czasu okna, musisz ponownie wybrać agenta.
W sekcji Poświadczenia administratora wprowadź następujący adres URL. Zastąp {connectorName}
część nazwą łącznika na hoście łącznika ECMA. W nazwie łącznika jest rozróżniana wielkość liter i powinna mieć taki sam przypadek, jak skonfigurowano w kreatorze. Możesz również zastąpić localhost
ciąg nazwą hosta maszyny.
Właściwości | Wartość |
---|---|
Adres URL dzierżawy | https://localhost:8585/ecma2host_APP1/scim |
Wprowadź wartość tokenu wpisu tajnego zdefiniowaną podczas tworzenia łącznika.
Uwaga
Jeśli właśnie przypisano agenta do aplikacji, zaczekaj 10 minut na ukończenie rejestracji. Test łączności nie będzie działać, dopóki rejestracja nie zostanie ukończona. Wymuszanie ukończenia rejestracji agenta przez ponowne uruchomienie agenta aprowizacji na serwerze może przyspieszyć proces rejestracji. Przejdź do serwera, wyszukaj usługi na pasku wyszukiwania systemu Windows, zidentyfikuj usługę Microsoft Entra Connect Provisioning Agent Service, wybierz prawym przyciskiem myszy usługę i uruchom ponownie.
Wybierz pozycję Testuj połączenie i zaczekaj minutę.
Po pomyślnym przetestowaniu połączenia i wskazaniu, że podane poświadczenia są autoryzowane do włączenia aprowizacji, wybierz pozycję Zapisz.
Teraz zamapujesz atrybuty między reprezentacją użytkownika w identyfikatorze Entra firmy Microsoft i reprezentacją użytkownika w aplikacji.
Użyjesz witryny Azure Portal, aby skonfigurować mapowanie między atrybutami użytkownika firmy Microsoft Entra i atrybutami wybranymi wcześniej w kreatorze konfiguracji hosta ECMA.
Upewnij się, że schemat Entra firmy Microsoft zawiera atrybuty wymagane przez aplikację. Jeśli wymaga to od użytkowników posiadania atrybutu, a ten atrybut nie jest jeszcze częścią schematu Microsoft Entra dla użytkownika, musisz użyć funkcji rozszerzenia katalogu , aby dodać ten atrybut jako rozszerzenie.
W centrum administracyjnym firmy Microsoft Entra w obszarze Aplikacje dla przedsiębiorstw wybierz aplikację lokalną aplikacji ECMA, a następnie stronę Aprowizowanie .
Wybierz pozycję Edytuj aprowizację i poczekaj 10 sekund.
Rozwiń węzeł Mapowania i wybierz pozycję Aprowizuj użytkowników firmy Microsoft Entra. Jeśli po raz pierwszy skonfigurowano mapowania atrybutów dla tej aplikacji, dla symbolu zastępczego będzie istnieć tylko jedno mapowanie.
Aby potwierdzić, że schemat aplikacji jest dostępny w identyfikatorze Entra firmy Microsoft, zaznacz pole wyboru Pokaż opcje zaawansowane i wybierz pozycję Edytuj listę atrybutów dla pozycji ScimOnPremises. Upewnij się, że wszystkie atrybuty wybrane w kreatorze konfiguracji są wyświetlane. Jeśli tak nie jest, zaczekaj kilka minut na odświeżenie schematu, a następnie załaduj ponownie stronę. Po wyświetleniu atrybutów na liście anuluj z tej strony, aby powrócić do listy mapowań.
Teraz wybierz mapowanie PLACEHOLDER userPrincipalName. To mapowanie jest domyślnie dodawane podczas pierwszej konfiguracji aprowizacji lokalnej.
Zmień wartość tak, aby odpowiadała następującej wartości:
Typ mapowania | Atrybut źródłowy | Atrybut docelowy |
---|---|---|
Direct | userPrincipalName | urn:ietf:params:scim:schemas:extension:ECMA2Host:2.0:User:userName |
Teraz wybierz pozycję Dodaj nowe mapowanie i powtórz następny krok dla każdego mapowania.
Określ atrybuty źródłowe i docelowe dla każdego z atrybutów, których wymaga aplikacja. Na przykład:
Atrybut Entra firmy Microsoft | Atrybut ScimOnPremises | Dopasowywanie pierwszeństwa | Zastosuj to mapowanie |
---|---|---|---|
ToUpper(Word([userPrincipalName], 1, "@"), ) | urn:ietf:params:scim:schemas:extension:ECMA2Host:2.0:User:userName | 1 | Tylko podczas tworzenia obiektu |
Redact("Pass@w0rd1") | urn:ietf:params:scim:schemas:extension:ECMA2Host:2.0:User:export_password | Tylko podczas tworzenia obiektu | |
miejscowość | urn:ietf:params:scim:schemas:extension:ECMA2Host:2.0:User:city | Zawsze | |
nazwa_firmy | urn:ietf:params:scim:schemas:extension:ECMA2Host:2.0:User:company | Zawsze | |
department | urn:ietf:params:scim:schemas:extension:ECMA2Host:2.0:User:department | Zawsze | |
poczta | urn:ietf:params:scim:schemas:extension:ECMA2Host:2.0:User:email | Zawsze | |
Switch([IsSoftDeleted], , "False", "9999-12-31", "True", "1990-01-01") | urn:ietf:params:scim:schemas:extension:ECMA2Host:2.0:User:expirationTime | Zawsze | |
givenName | urn:ietf:params:scim:schemas:extension:ECMA2Host:2.0:User:firstName | Zawsze | |
surname | urn:ietf:params:scim:schemas:extension:ECMA2Host:2.0:User:lastName | Zawsze | |
telephoneNumber | urn:ietf:params:scim:schemas:extension:ECMA2Host:2.0:User:phoneNumber | Zawsze | |
jobTitle | urn:ietf:params:scim:schemas:extension:ECMA2Host:2.0:User:jobTitle | Zawsze |
Po dodaniu wszystkich mapowań wybierz Zapisz.
Teraz, gdy masz Microsoft Entra ECMA Connector Host komunikujący się z Microsoft Entra ID oraz skonfigurowane mapowanie atrybutów, możesz przejść do konfigurowania, kto znajduje się w zakresie aprowizacji.
Ważne
Jeśli zalogowano się przy użyciu roli administratora tożsamości hybrydowej, musisz wylogować się i zalogować się przy użyciu konta, które ma co najmniej rolę Administratora aplikacji dla tej sekcji. Rola administratora tożsamości hybrydowej nie ma uprawnień do przypisywania użytkowników do aplikacji.
Jeśli w aplikacji istnieją użytkownicy, należy utworzyć przypisania ról aplikacji dla tych istniejących użytkowników. Aby dowiedzieć się więcej na temat zbiorczego tworzenia przypisań ról aplikacji, zobacz Zarządzanie istniejącymi użytkownikami aplikacji w identyfikatorze Entra firmy Microsoft.
W przeciwnym razie, jeśli nie ma bieżących użytkowników aplikacji, wybierz użytkownika testowego z firmy Microsoft Entra, który zostanie aprowizacji w aplikacji.
Upewnij się, że wybrany użytkownik ma wszystkie właściwości, które mają być mapowane na wymagane atrybuty aplikacji.
W witrynie Azure Portal wybierz pozycję Aplikacje dla przedsiębiorstw.
Wybierz lokalną aplikację ECMA.
Po lewej stronie w obszarze Zarządzaj wybierz pozycję Użytkownicy i grupy.
Wybierz pozycję Dodaj użytkownika/grupę.
W obszarze Użytkownicy wybierz pozycję Brak zaznaczone.
Wybierz użytkowników z prawej strony i wybierz przycisk Wybierz .
Teraz wybierz pozycję Przypisz.
Po zamapowaniu atrybutów i przypisaniu użytkowników możesz przetestować aprowizację na żądanie przy użyciu jednego z użytkowników.
W witrynie Azure Portal wybierz pozycję Aplikacje dla przedsiębiorstw.
Wybierz lokalną aplikację ECMA.
Po lewej stronie wybierz pozycję Aprowizowanie.
Wybierz pozycję Aprowizuj na żądanie.
Wyszukaj jednego z użytkowników testowych i wybierz pozycję Aprowizuj.
Po kilku sekundach pojawi się komunikat : "Pomyślnie utworzono użytkownika w systemie docelowym". Dołączona zostanie lista atrybutów użytkownika.
Po pomyślnym zainicjowaniu aprowizacji na żądanie wróć do strony konfiguracji aprowizacji. Upewnij się, że zakres jest ustawiony na tylko przypisanych użytkowników i grupy, włącz aprowizację i wybierz pozycję Zapisz.
Poczekaj do 40 minut na uruchomienie usługi aprowizacji. Po zakończeniu zadania aprowizacji, zgodnie z opisem w następnej sekcji, jeśli skończysz testowanie, możesz zmienić stan aprowizacji na Wyłączone, a następnie wybrać pozycję Zapisz. Ta akcja uniemożliwia uruchomienie usługi aprowizacji w przyszłości.
Jeśli zostanie wyświetlony błąd, wybierz pozycję Wyświetl dzienniki aprowizacji. Wyszukaj w dzienniku wiersz, w którym stan to Niepowodzenie, a następnie wybierz go w tym wierszu.
Aby uzyskać więcej informacji, przejdź na kartę Rozwiązywanie problemów i zalecenia .
Zdarzenia
9 kwi, 15 - 10 kwi, 12
Zakoduj przyszłość za pomocą sztucznej inteligencji i połącz się z elementami równorzędnymi i ekspertami języka Java w witrynie JDConf 2025.
Zarejestruj się teraz