Wypełnij poniższe sekcje, aby utworzyć konto użytkownika systemu integracji (ISU) i konto grupy zabezpieczeń (SG) w celu uzyskania dostępu API do Workday z Workiva.
Proces ten obejmuje trzy główne zadania.
- Utwórz konto użytkownika systemu integracji (ISU).
- Utwórz grupę zabezpieczeń.
- Przypisz i aktywuj zasady zabezpieczeń i uprawnienia domeny.
- Przetestuj i zweryfikuj dostęp do konta.
Utwórz konto użytkownika systemu integracji (ISU)
Wykonaj następujące kroki, aby utworzyć konto użytkownika systemu integracji (ISU), które będzie używane przez Workiva.
- Zaloguj się do swojej dzierżawy Workday jako administrator (lub użytkownik z odpowiednimi uprawnieniami bezpieczeństwa).
- W polu wyszukiwania Workday wpisz Create Integration System User i wybierz to zadanie.
- Wprowadź nazwę użytkownika . Na przykład: ISU_WorkivaChain_API_User.
Zalecamy użycie terminu takiego jak "API_User" lub "outbound", aby wskazać, że jest on przeznaczony dla żądań wychodzących. - Wprowadź i zweryfikuj hasło .
Upewnij się, że hasło jest zgodne z zasadami struktury haseł dzierżawcy. - Odznacz Wymagaj nowego hasła przy następnym logowaniu.
Dzięki temu konto nie jest zmuszane do zmiany hasła przy pierwszym logowaniu. - Ponieważ to konto jest przeznaczone wyłącznie do użytku API/integracji i nie powinno być używane do interaktywnego logowania, zaznacz pole wyboru Do Not Allow UI Sessions.
- (Opcjonalnie) Ustaw wartość Session Timeout Minutes na odpowiednią wartość dla potrzeb integracji. Ustawienie tej wartości na 0 oznacza, że sesja nie wygasa.
- Kliknij OK, aby utworzyć konto.
- Na następnym ekranie kliknij Done, aby zakończyć tworzenie jednostki ISU.
- (Opcjonalnie) Przejdź do zadania "Maintain Password Rules" i dodaj tę nową jednostkę ISU do listy "System Users exempt from password expiration", aby hasło nie wygasło i nie przerwało integracji.
Utwórz grupę zabezpieczeń
Wykonaj następujące kroki, aby utworzyć specjalną grupę zabezpieczeń dla ISU. W ten sposób możesz ograniczyć ją tylko do wykonywania akcji Get Workers.
- W polu wyszukiwania Workday wpisz Create Security Group i wybierz to zadanie.
- Wybierz żądany typ Tenanted Security Group. Ten zestaw instrukcji wykorzystuje "Integration System Security Group (Unconstrained)",
, ale jeśli twoja polityka bezpieczeństwa wymaga bardziej restrykcyjnej polityki, "Constrained" powinna również działać, ale nie została przetestowana.
Uwaga: Istnieją dwa rodzaje grup zabezpieczeń: ograniczone i nieograniczone.
Grupa zabezpieczeń constrained zapewnia, że usługa internetowa zwraca wyniki ograniczone do określonej organizacji nadzorującej. Grupa zabezpieczeń unconstrained pozwala użytkownikowi na odpytywanie dowolnych Workerów w twojej dzierżawie.
- Wprowadź nazwę dla grupy. Na przykład SG_WorkivaChain_Group.
- Kliknij OK.
- W polu Użytkownicy systemu integracji znajdź i wybierz użytkownika ISU utworzonego w Utwórz konto użytkownika systemu integracji (ISU). (ISU_WorkivaChain_API_User).
- Kliknij OK.
- Kliknij Done na poniższym ekranie.
Przypisz zasady zabezpieczeń domeny (uprawnienia)
W Workday domena kontroluje dostęp do określonego zestawu danych lub działań. Na przykład "Dane pracowników: Public Worker Reports" określa, kto może wywoływać operację Get_Workers w usłudze internetowej "Staffing". Ten krok definiuje, jakie dane i jakie działania może wykonywać grupa zabezpieczeń (a tym samym ISU). Dla każdej domeny (obszaru danych / funkcji), do której ma mieć dostęp Twoja integracja, musisz ustawić uprawnienia do aktywności dla grupy zabezpieczeń.
Wymagane zasady bezpieczeństwa domeny Workday
Następujące zasady zabezpieczeń domeny i wartości dostępu są wymagane dla polecenia Get Workers.
| Polityka bezpieczeństwa domeny | Dostęp | Obszar funkcjonalny |
| Dane pracowników: Raporty dotyczące pracowników publicznych | Pobierz tylko | Personel |
| Dane pracowników: Bieżące informacje o personelu | Pobierz tylko | Personel |
| Dane pracowników: Umiejętności i doświadczenie | Pobierz tylko | Profil i umiejętności pracownika |
Ustaw uprawnienia grupy zabezpieczeń
Wykonaj następujące kroki, aby ustawić uprawnienia dla grupy zabezpieczeń, która będzie używana przez Workiva.
- W polu Workday Search wpisz Maintain Permissions for Security Group i wybierz to zadanie (otworzy się okno dialogowe Maintain Permissions for Security Group ).
- Na stronie Operation wybierz opcję "Maintain".
- W polu Source Security Group znajdź i wybierz nazwę grupy utworzonej w Create a Security Group (tej, której członkiem jest Twoja jednostka ISU). W tym przykładzie jest to "SG_WorkivaChain_Group".
- Kliknij OK.
- Kliknij przycisk Dodaj (+) w lewym górnym rogu tabeli, aby dodać nowy wiersz, a następnie wyszukaj w kolumnie Domain Security Policy politykę domeny "WorkerData: Publiczne raporty pracowników"
- Znajdź kolumnę View/Modify Access i wybierz Get Only (ustawia to dostęp tylko do odczytu).
- Powtórz kroki 5 i 6 dla "Danych pracowników: Bieżące informacje o pracownikach" i "Dane pracowników: Umiejętności i doświadczenie".
- Kliknij OK, aby zapisać zmiany.
- Kliknij OK.
- Kliknij Gotowe.
Aktywuj zmiany w polityce bezpieczeństwa
Wykonaj następujące kroki, aby aktywować wprowadzone zmiany w Workday Security Policy.
- W polu Workday Search wpisz Activate Pending Security Policy Changes i wybierz to zadanie.
-
Wprowadź krótki komentarz opisujący zmianę.
Na przykład "Stosowanie zasad domeny do grupy zabezpieczeń SG_WorkivaChain_Group".Ostrzeżenie: Ta zmiana spowoduje zastosowanie wszystkich oczekujących zmian zasad zabezpieczeń, potencjalnie wpływając na inne grupy zabezpieczeń niż ta, którą właśnie skonfigurowałeś. Przed kontynuowaniem sprawdź, czy nie ma innych oczekujących zmian zasad bezpieczeństwa.
- Kliknij OK.
- Zaznacz pole wyboru Confirm w następnym oknie dialogowym i kliknij OK, aby uaktywnić te zmiany.
- Twoja grupa zabezpieczeń może teraz uruchomić usługę internetową Get Worker.
(Opcjonalnie) Usunięcie ogólnego dostępu z domeny "Worker Data: Pracownik"
Konfiguracje dzierżawców Workday mogą się różnić w zależności od instancji. Jeśli "Wszyscy użytkownicy" otrzymali dostęp do odczytu, skorzystaj z poniższych wskazówek, aby ograniczyć uprawnienia użytkownika systemu integracji Workiva tylko do tego, co jest wymagane.
WAŻNE: Ta instrukcja została napisana w celu implementacji łańcucha pobierania danych Get_Worker i będzie musiała zostać zmodyfikowana do każdego innego zastosowania.
Uwaga: Usunięcie opcji "Wszyscy użytkownicy" będzie wymagało wyraźnego określenia grup, które powinny mieć dostęp do polityki domeny "Worker Data: Worker".
Usuń ogólny dostęp z domeny "Worker Data: Pracownik"
Wykonaj następujące kroki, aby usunąć ogólny dostęp z domeny "Worker Data: Worker".
- W polu wyszukiwania Workday wpisz Domain Security Configuration i wybierz to zadanie.
- W monicie wyszukaj i wybierz domenę "Worker Data: Worker".
- Po otwarciu tej strony kliknij menu Related Actions (mały szary przycisk z trzema kropkami lub strzałką).
- Poruszaj się po menu w następujący sposób:
- Wybierz Domena, a następnie Edytuj uprawnienia polityki bezpieczeństwa.
- Przewiń w dół do sekcji Integration Permissions.
- Znajdź wiersz dla grupy zabezpieczeń All Users.
- Kliknij przycisk X, aby go usunąć.
- Kliknij OK, aby zapisać zmiany i uczynić je aktywnymi.
Aktywuj zmiany w polityce bezpieczeństwa
Ważna uwaga: Ta zmiana może mieć wpływ na inne integracje lub raporty, które opierają się na opcji "Wszyscy użytkownicy", więc najpierw przetestuj ją w piaskownicy i sprawdź, czy ta zmiana nie zepsuje żadnych innych procesów.
Wykonaj następujące kroki, aby aktywować zmiany w zasadach bezpieczeństwa.
- W polu Workday Search wpisz Activate Pending Security Policy Changes i wybierz to zadanie.
- Wprowadź krótki komentarz opisujący zmianę.
Na przykład "Usunięto grupę zabezpieczeń "Wszyscy użytkownicy"". - Kliknij OK, aby zapisać zmiany i uczynić je aktywnymi.
Dodaj swoją grupę zabezpieczeń do "Worker Data: Pracownik"
Po usunięciu otwartego dostępu musisz teraz wyraźnie nadać grupie ISU uprawnienia, których potrzebuje. W tym celu wykonaj następujące kroki.
- W polu wyszukiwania Workday wpisz Domain Security Configuration i wybierz to zadanie.
- W monicie wyszukaj i wybierz domenę "Worker Data: Worker".
(Być może jesteś już na tym ekranie) - Po otwarciu tej strony kliknij menu Related Actions.
- Poruszaj się po menu w następujący sposób:
- Wybierz domenę, a następnie Edytuj uprawnienia polityki bezpieczeństwa.
- Przewiń w dół do sekcji Integration Permissions.
- Kliknij przycisk Dodaj (+) w tej sekcji.
- Znajdź i dodaj grupę zabezpieczeń utworzoną w sekcji Create a Security Group.
- Przyznaj Uzyskaj pozwolenie. Pozwala to integracji na wyszukiwanie danych Worker.
- Kliknij OK, aby zapisać zmiany i uczynić je aktywnymi.
- Uruchom ponownie proces "Activate Security Policy Changes".
Twoja grupa zabezpieczeń (i jej członkowie) może teraz wykonać wywołanie API Get_Worker i pobrać publiczne dane Workera, podczas gdy grupa "Wszyscy użytkownicy" nie ma już takiego dostępu.
Przetestuj i zweryfikuj
Przetestuj i sprawdź, czy możesz użyć poświadczeń ISU (lub systemu integracji korzystającego z tych poświadczeń), aby wykonać wywołanie API Get_Worker. Jeśli się powiedzie, otrzymasz dane pracownika zdefiniowane w zasadach domeny "Raporty pracowników publicznych" i "Pracownik". Jeśli otrzymasz komunikat "nieautoryzowane" (kod błędu HTML 401 lub 403) lub "brak danych" (kod błędu HTML 404), sprawdź dwukrotnie, czy aktywowałeś oczekujące zmiany zasad po każdym z powyższych kroków.
Uwaga: Zgodnie z implementacją Workiva, dane zwracane przez wywołanie Get_Worker są podzbiorem możliwych danych Workera, które mogą zostać zwrócone. Aby uzyskać informacje na temat dostępnych pól, zapoznaj się z sekcją "Modyfikacja karty poleceń" na stronie pomocy technicznej Workiva Karty konfiguracji poleceń Get Workers.
Uwagi
- Ten dokument zakłada, że domyślnie domena "Worker Data: Worker" jest dostarczana z grupą "Wszyscy użytkownicy".
- Ten dokument zakłada, że domyślnie wszystkie konta (w tym ISU) są automatycznie dodawane do grupy "Wszyscy użytkownicy" po utworzeniu.
- W przypadku pól wrażliwych (takich jak dane osobowe) Workday stosuje zabezpieczenia na poziomie pola. Aby ujawnić prywatne atrybuty (e-mail, telefon itp.), musisz zmodyfikować te zasady na poziomie pola osobno - zapobiega to nadmiernemu ujawnianiu poufnych informacji.
- Jak zawsze, prosimy o dokładne przetestowanie wszystkich integracji w dzierżawie Sandbox lub Implementation, ponieważ niezastosowanie się do tego zalecenia może mieć niezamierzony wpływ na integracje inne niż ta, w której pracujesz.
- Aby uzyskać więcej informacji na temat usługi internetowej Get_Workers, zapoznaj się z tą stroną pomocy technicznej Workday: Concept: Get Workers SOAP Web Service Guidelines and Troubleshooting.
- Ponieważ może istnieć wiele domen kontrolujących dostęp do sekcji danych, zapoznaj się z dokumentem Get_Workers API i wyszukaj termin "Domain", ponieważ dostarczy on przydatnych informacji o tym, które domeny kontrolują daną sekcję.
- Wymienione w tym dokumencie Required Workday domain security policies to minimalne uprawnienia wymagane do wywoływania interfejsu API przez konektor.
- Przejrzyj stronę Reference: Raporty związane z bezpieczeństwem, aby uzyskać szczegółowe informacje na temat dostępnych raportów związanych z bezpieczeństwem.
Aby uzyskać instrukcje dotyczące konfigurowania połączenia Get Worker w Chains, zapoznaj się ze stroną pomocy technicznej Workiva Konfigurowanie połączenia Get Worker w Chains.