Decyzja sygnatury dostępu współdzielonego (wersja zapoznawcza)
Decyzja sas łączy sztuczną inteligencję i reguły biznesowe w celu automatyzacji decyzji operacyjnych na dużą skalę. Ten łącznik służy do uruchamiania modeli decyzyjnych wdrożonych na platformie Sas Viya.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Obsługa sygnatury dostępu współdzielonego |
| adres URL | https://support.sas.com |
| support@sas.com |
| Metadane łącznika | |
|---|---|
| Publisher | SAS Institute, Inc. |
| Witryna internetowa | https://www.sas.com |
| Zasady ochrony prywatności | https://www.sas.com/en_us/legal/privacy.html |
| Kategorie | AI; Dane |
Inteligentne podejmowanie decyzji sygnatury dostępu współdzielonego w usłudze Viya łączy zarządzanie regułami biznesowymi, przetwarzanie decyzji, wykrywanie zdarzeń w czasie rzeczywistym, zarządzanie decyzjami i zaawansowaną analizę sygnatur dostępu współdzielonego, aby zautomatyzować decyzje w przedsiębiorstwie i zarządzać nimi. Inteligentne podejmowanie decyzji dotyczących sygnatur dostępu współdzielonego pomaga przyspieszyć operacjonalizacja modeli analitycznych, w tym zarówno modeli SAS, jak i tych opracowanych za pomocą platform typu open source. Obsługuje ona proces decyzyjny w usługach kredytowych, zapobieganiu oszustwom, produkcji, spersonalizowanym marketingu i wielu innych przypadkach użycia.
Łącznik podejmowania decyzji sygnatury dostępu współdzielonego umożliwia użytkownikom łączenie się ze środowiskiem SAS Viya i uruchamianie wybranych modułów decyzyjnych i modeli analitycznych. Przykładowe przypadki użycia łącznika decyzyjnego sygnatury dostępu współdzielonego obejmują:
- Określanie, czy zawartość wiadomości e-mail jest zgodna z zasadami firmowymi firmy
- Ocenianie kandydata do pracy na podstawie opinii kwalifikacyjnej
- Ocenianie szansy sprzedaży
- Określanie, czy faktura jest legalna
- Automatyczne zatwierdzanie raportu wydatków
Aby dowiedzieć się więcej na temat inteligentnej decyzyjnej sygnatury dostępu współdzielonego i zażądać bezpłatnej wersji próbnej, odwiedź stronę https://www.sas.com/en_us/software/intelligent-decisioning.html.
Wymagania wstępne
- Użytkownik musi mieć istniejącą licencję sas Intelligent Decisioning.
- Użytkownik musi skonfigurować środowisko inteligentnej decyzyjnej sygnatury dostępu współdzielonego, aby zezwolić na wywołania pochodzące z adresów IP opisanych w temacie Zakresy adresów IP platformy Azure.
Jak używać łącznika decyzyjnego sygnatury dostępu współdzielonego
- Zarejestruj aplikacje klienckie.
- Uzyskaj token dostępu do użycia podczas nawiązywania połączenia ze środowiskiem SAS Viya.
- Połącz się ze środowiskiem SAS Viya.
Rejestrowanie klientów
Wszystkie aplikacje i skrypty korzystające z interfejsów API REST sas Viya muszą być zarejestrowane w środowisku SAS. Administrator sygnatury dostępu współdzielonego musi użyć usługi OAuth w Menedżerze logowania sygnatury dostępu współdzielonego, aby zażądać tokenu dostępu i zarejestrować klienta. Menedżer logowania sygnatury dostępu współdzielonego wystawia tokeny dostępu OAuth w odpowiedzi na żądania zawierające prawidłowy token z serwera konfiguracji sygnatury dostępu współdzielonego. Łącznik podejmowania decyzji sygnatury dostępu współdzielonego używa tokenu elementu nośnego OAuth jako klucza interfejsu API.
Aby zarejestrować klienta:
Znajdź prawidłowy token konsula. Administrator sygnatury dostępu współdzielonego może znaleźć token w pliku client.token wewnątrz
/opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/defaultzasobnikasas-consul-server-0. Aby pobrać ciąg tokenu consul w systemie Linux, uruchom następujące polecenie:kubectl exec sas-consul-server-0 -- \ cat /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/default/client.tokenZażądaj tokenu OAuth, publikując żądanie do
/SASLogon/oauth/clients/consul. Określ token konsula z kroku 1 wX-Consul-Tokenpolu. Aby na przykład zażądać tokenu dla klienta o nazwieapp, prześlij następujące polecenie:curl -X POST "https://server.example.com/SASLogon/oauth/clients/consul?callback=false&serviceId=app" \ -H "X-Consul-Token: <consul-token-from-step-1>"Parametr zapytania Description wywołanie zwrotne Określ false, aby otrzymać token dostępu w odpowiedzi. W przeciwnym razie token jest wysyłany do usługi zarejestrowanej na serwerze konfiguracji sygnatury dostępu współdzielonego.serviceId (identyfikator usługi) Określ nazwę klienta, który chcesz zarejestrować. W odpowiedzi na żądanie menedżer logowania sygnatury dostępu współdzielonego zwraca odpowiedź JSON zawierającą token dostępu w polu access_token .
Zarejestruj aplikację kliencką, publikując żądanie w witrynie
/SASLogon/oauth/clients. Określ token dostępu zwrócony w kroku 2 jako wartość nagłówkaAuthorization:curl -X POST "https://server.example.com/SASLogon/oauth/clients" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <access-token-from-step-2>" \ -d '{ "client_id": "<client-id-goes-here>", "client_secret": "<client-secret-goes-here>", "scope": ["openid"], "authorized_grant_types": ["client_credentials"], "access_token_validity": 43199 }'Napiwek: Domyślnie token jest ważny przez 12 godzin (lub 43200 sekund). Aby ustawić krótszy lub dłuższy czas trwania, ustaw
access_token_validitypole zgodnie z potrzebami, używając wartości całkowitej w sekundach.Nuta: Istnieją inne obsługiwane "authorized_grant_types", ale łącznik podejmowania decyzji sygnatury dostępu współdzielonego oczekuje
client_credentialsobecnie typu dotacji.
Jeśli żądanie zakończy się pomyślnie, klient zostanie zarejestrowany. Pomyślna odpowiedź JSON wygląda podobnie do następującego przykładu:
{"scope":["openid"],"client_id":"<requested-client-id>","resource_ids":["none"],"authorized_grant_types":["client_credentials"],
"access_token_validity":43199,"authorities":["uaa.none"],"lastModified":1521124986406}
Uzyskiwanie tokenów dostępu
Zarejestrowani klienci mogą zażądać tokenu dostępu przy użyciu interfejsu API logowania współdzielonego OAuth. Aby zażądać tokenu dostępu, opublikuj żądanie do punktu końcowego /SASLogon/oauth/token i określ formę autoryzacji. Autoryzacja jest wyrażona w formie udzielenia autoryzacji. Obecnie interfejsy API REST sas Viya obsługują client_credentials typ przyznawania.
Na przykład przy użyciu identyfikatora klienta "myclient" z wpisem tajnym "mysecret" można zażądać tokenu w następujący sposób:
curl -X POST "https://server.example.com/SASLogon/oauth/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=myclient&client_secret=mysecret"
Odpowiedź JSON zawiera pole o nazwie access_token zawierające wartość tokenu używanego przez łącznik podejmowania decyzji SAS do tworzenia połączeń usługi Power Automate. Po wygaśnięciu tokenu opublikuj nowe żądanie w punkcie /SASLogon/oauth/token końcowym.
Nawiązywanie połączenia ze środowiskiem Sas Viya
Aby nawiązać połączenie ze środowiskiem SAS Viya, potrzebne są następujące informacje:
| Nazwa parametru | Description |
|---|---|
| Adres URL środowiska Viya sygnatury dostępu współdzielonego | Adres URL wdrożenia inteligentnej decyzyjnej sygnatury dostępu współdzielonego. Przykład: https://server.example.com |
| Token autoryzacji | Token dostępu zwrócony z polecenia w sekcji Uzyskiwanie tokenów dostępu powyżej. Prefiks tokenu za pomocą Bearer polecenia . |
Połączenie może być współużytkowane przez użytkowników.
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Udostępnialne |
Domyślny
Dotyczy: Wszystkie regiony
Parametry tworzenia połączenia.
Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Adres URL środowiska Viya sygnatury dostępu współdzielonego | ciąg | Określanie adresu URL środowiska Sas Viya | Prawda |
| Token autoryzacji | securestring | Token autoryzacji dla tego interfejsu API | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Krok uruchamiania |
Wykonuje krok z określonymi wartościami wejściowymi. Zmienna |
Krok uruchamiania
Wykonuje krok z określonymi wartościami wejściowymi. Zmienna outputs w odpowiedzi zawiera dane wyjściowe wykonania.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
moduł
|
moduleId | True | string |
Identyfikator modułu, który zawiera krok do wykonania. |
|
krok
|
stepId | True | string |
Identyfikator kroku do wykonania. |
|
nazwa
|
name | string |
Nazwa zmiennej. |
|
|
value
|
value |
Wartość zmiennej. |
Zwraca
Ten typ opisuje wartości wyjściowe zwracane po wykonaniu kroku.
- Dane wyjściowe kroku
- stepOutput
Wyzwalacze
| Gdy zasób jest weryfikowany |
Tworzy nowy element webhook na potrzeby ukończenia dowolnego zdarzenia oceniania. |
| Kiedy wystąpiło wstępnie zdefiniowane zdarzenie |
Tworzy nowy element webhook dla wstępnie zdefiniowanego zdarzenia typu zawartości wywołania zwrotnego. |
| Po opublikowaniu zasobu |
Tworzy nowy element webhook dla zdarzenia publikowania. |
Gdy zasób jest weryfikowany
Tworzy nowy element webhook na potrzeby ukończenia dowolnego zdarzenia oceniania.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Prefiks ścieżki zasobu
|
resourcePath | True | string |
Ścieżka zasobu w folderze. |
|
State
|
state | True | string |
Zwraca
Zawartość weryfikacji wywołania zwrotnego. Reprezentuje to typ nośnika application/vnd.sas.webhook.callback.validate (wersja 1).
- Sprawdzanie poprawności wywołania zwrotnego elementu webhook
- webhookCallbackValidate
Kiedy wystąpiło wstępnie zdefiniowane zdarzenie
Tworzy nowy element webhook dla wstępnie zdefiniowanego zdarzenia typu zawartości wywołania zwrotnego.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Typ zawartości wywołania zwrotnego
|
callbackContentType | True | string |
Typ zawartości wywołania zwrotnego. |
|
Filtr zawartości wywołania zwrotnego
|
callbackContentFilter | string |
Filtruj zawartość wywołania zwrotnego. |
Zwraca
Zawartość ogólnego wywołania zwrotnego.
- Wywołanie zwrotne elementu webhook — ogólne
- webhookCallbackGeneric
Po opublikowaniu zasobu
Tworzy nowy element webhook dla zdarzenia publikowania.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Prefiks ścieżki zasobu
|
resourcePath | True | string |
Ścieżka zasobu w folderze. |
|
Typ miejsca docelowego
|
destinationType | True | string |
Zwraca
Zawartość publikowania wywołania zwrotnego. Reprezentuje to typ nośnika application/vnd.sas.webhook.callback.publish (wersja 1).
- Publikowanie wywołania zwrotnego elementu webhook
- webhookCallbackPublish
Definicje
anyVariableValue
stepOutput
Ten typ opisuje wartości wyjściowe zwracane po wykonaniu kroku.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
moduleId
|
moduleId | string |
Identyfikator modułu, który zawiera wykonany krok. |
|
stepId
|
stepId | string |
Nazwa kroku, który wygenerował te dane wyjściowe. |
|
Wyniki
|
outputs | array of variable |
Wartości wyjściowe zwracane z wykonanego kroku. Kolejność zmiennych jest zgodna z kolejnością przedstawioną w podpisie wyjściowym. |
zmienna
Para nazwa/wartość reprezentująca zmienną wejściową lub wyjściową.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
|
name | string |
Nazwa zmiennej. |
|
value
|
value | anyVariableValue |
Wartość zmiennej. |
łącze
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
href
|
href | string |
Adres URL linku. |
|
typPrzedmiotu
|
itemType | string |
Jeśli jest to link do kontenera, |
|
metoda
|
method | string |
Metoda HTTP łącza. |
|
Rel
|
rel | string |
Relacja łącza do zasobu. |
|
responseItemType
|
responseItemType | string |
Typ nośnika lub typ łącza elementów w treści odpowiedzi dla |
|
responseType (typ odpowiedzi)
|
responseType | string |
Typ nośnika lub typ łącza treści odpowiedzi dla |
|
title
|
title | string |
Tytuł linku. |
|
typ
|
type | string |
Typ nośnika lub typ łącza dla linku. |
|
URI
|
uri | string |
Względny identyfikator URI łącza. |
element webhookCallbackValidate
Zawartość weryfikacji wywołania zwrotnego. Reprezentuje to typ nośnika application/vnd.sas.webhook.callback.validate (wersja 1).
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
state | string |
Określ, czy jest to sukces, czy niepowodzenie. |
|
resourceUri
|
resourceUri | string |
Identyfikator URI zasobu, na którym jest wykonywana walidacja. |
|
resourcePath (ścieżka zasobu)
|
resourcePath | string |
Ścieżka zasobu w folderze. |
|
resourceVersion
|
resourceVersion | string |
Wersja zasobu, na którym jest wykonywana walidacja. |
|
validationType
|
validationType | string |
Typ weryfikacji wykonywanej na zasobie. |
|
links
|
links | array of link |
Zero lub więcej linków do powiązanych zasobów lub operacji. |
|
wersja
|
version | integer |
Numer wersji schematu tego typu nośnika. Ta reprezentacja to wersja 1. |
webhookCallbackPublish
Zawartość publikowania wywołania zwrotnego. Reprezentuje to typ nośnika application/vnd.sas.webhook.callback.publish (wersja 1).
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
resourceUri
|
resourceUri | string |
Identyfikator URI zasobu, który jest publikowany. |
|
resourcePath (ścieżka zasobu)
|
resourcePath | string |
Ścieżka zasobu w folderze. |
|
resourceVersion
|
resourceVersion | string |
Wersja zasobu, który jest publikowany. |
|
destinationType (typ miejsca docelowego)
|
destinationType | string |
Typ miejsca docelowego, w którym jest publikowany zasób. |
|
zamienić
|
replace | boolean |
Wskazuje, czy zasób jest publikowany po raz pierwszy, czy zastąpiony. |
|
links
|
links | array of link |
Zero lub więcej linków do powiązanych zasobów lub operacji. |
|
wersja
|
version | integer |
Numer wersji schematu tego typu nośnika. Ta reprezentacja to wersja 1. |
webhookCallbackGeneric
Zawartość ogólnego wywołania zwrotnego.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
links
|
links | array of link |
Zero lub więcej linków do powiązanych zasobów lub operacji. |
|
wersja
|
version | integer |
Numer wersji schematu tego typu nośnika. Ta reprezentacja to wersja 1. |