Microsoft Information Protection SDK – koncepty ověřování

Pokud chcete provést ověření v sadě MIP SDK, rozšiřte mip::AuthDelegate třídu tak, aby implementovala upřednostňovanou metodu ověřování. mip::AuthDelegate obsahuje:

  • mip::AuthDelegate::OAuth2Challenge – třída, která spravuje informace autority OAuth 2.0 a poskytuje ji klientské aplikaci.
  • mip::AuthDelegate::OAuth2Token – třída, která spravuje získání přístupového tokenu OAuth 2.0 z klientské aplikace a úložiště tokenů.
  • mip::AuthDelegate::AcquireOAuth2Token() – čistě virtuální funkce, jejíž implementace určuje metodu získání přístupového tokenu. Poté, co ji sada SDK zavolá, implementace získá přístupový token a předá jej zpět autentizační logice sady SDK.

mip::AuthDelegate::AcquireOAuth2Token přijme následující parametry a vrátí logickou hodnotu označující, jestli bylo získání tokenu úspěšné:

  • mip::Identity: Identita uživatele nebo služby pro ověřování, pokud je známa.
  • mip::AuthDelegate::OAuth2Challenge: Přijímá čtyři parametry: authority, resource, claims a scopes. Autorita je služba, která vygeneruje token. Prostředek je služba, ke které se aplikace pokouší získat přístup. Sada SDK tyto parametry předá delegátu při volání. Nároky jsou nároky specifické pro štítek vyžadované ochrannou službou. Rozsahy jsou oprávnění Microsoft Entra vyžadovaná pro přístup k prostředku.
  • mip::AuthDelegate::OAuth2Token: Sada SDK zapíše výsledek tokenu do tohoto objektu. SDK ji použije při načítání enginu. Mimo implementaci ověřování nemusíte tuto hodnotu nikde získat ani nastavit.

Important

Aplikace nevolají AcquireOAuth2Token přímo. Sada SDK volá tuto funkci v případě potřeby.

Další kroky

Kvůli zjednodušení ukázky, které demonstrují delegáta, implementují získání tokenu voláním externího skriptu. Tento skript můžete nahradit jiným skriptem, opensourcovou knihovnou OAuth 2.0 nebo vlastní knihovnou OAuth 2.0.