zestaw SDK Microsoft Information Protection — pojęcia dotyczące uwierzytelniania

Aby uwierzytelnić się w zestawie MIP SDK, rozszerz klasę mip::AuthDelegate w celu zaimplementowania preferowanej metody uwierzytelniania. mip::AuthDelegate Contains:

  • mip::AuthDelegate::OAuth2Challenge — klasa, która zarządza informacjami o urzędzie OAuth 2.0 i udostępnia ją aplikacji klienckiej.
  • mip::AuthDelegate::OAuth2Token — klasa, która zarządza uzyskiwaniem tokenu dostępu OAuth 2.0 z poziomu aplikacji klienckiej i magazynu tokenów.
  • mip::AuthDelegate::AcquireOAuth2Token() - czysta funkcja wirtualna, której implementacja określa metodę pozyskiwania tokenu dostępu. Po wywołaniu zestawu SDK implementacja uzyskuje token dostępu i udostępnia go z powrotem do logiki uwierzytelniania zestawu SDK.

mip::AuthDelegate::AcquireOAuth2Token Akceptuje następujące parametry i zwraca wartość logiczną wskazującą, czy pozyskiwanie tokenu powiodło się:

  • mip::Identity: tożsamość użytkownika lub usługi na potrzeby uwierzytelniania, jeśli jest znana.
  • mip::AuthDelegate::OAuth2Challenge: akceptuje cztery parametry: urząd, zasób, oświadczenia i zakresy. Urząd to usługa, która generuje token. Zasób to usługa, do których aplikacja próbuje uzyskać dostęp. SDK przekazuje te parametry delegatowi podczas jego wywołania. Oświadczenia są oświadczeniami specyficznymi dla etykiety wymaganymi przez usługę ochrony. Zakresy to zakresy uprawnień Microsoft Entra wymagane do uzyskania dostępu do zasobu.
  • mip::AuthDelegate::OAuth2Token: zestaw SDK zapisuje wynik tokenu dla tego obiektu. SDK wykorzystuje to podczas ładowania silnika. Poza implementacją uwierzytelniania nie trzeba pobierać ani ustawiać tej wartości w dowolnym miejscu.

Important

Aplikacje nie wywołują bezpośrednio AcquireOAuth2Token. Zestaw SDK wywołuje tę funkcję, jeśli jest to wymagane.

Następne kroki

Dla uproszczenia przykłady demonstrujące delegata implementują pozyskiwanie tokenów przez wywołanie skryptu zewnętrznego. Ten skrypt można zastąpić innym skryptem, biblioteką OAuth 2.0 typu open source lub niestandardową biblioteką OAuth 2.0.