OpenID Connect 允許你選擇性地向 UserInfo 端點和/或 ID 令牌請求回傳個別申訴。 理賠請求以包含請求清單的 JSON 物件表示。 更多詳情請參閱 OpenID Connect Core 1.0 。
Microsoft 驗證資源庫(MSAL)適用於 iOS 與 macOS,允許在互動式與靜默令牌取得情境下請求特定權利要求。 它是透過參數 claimsRequest 來實現的。
有多種情境需要這樣做。 例如:
- 申請申請超出你申請標準的申請。
- 為您的應用程式要求無法透過範圍指定的特定標準宣告組合。 例如,若存取權杖因缺少宣告而遭到拒絕,應用程式可使用 MSAL 要求這些缺少的宣告。
Note
每當指定權利要求時,MSAL 會繞過存取權杖快取。 重要的是只有在需要額外聲明時才提供 claimsRequest 參數(而不是每次 MSAL API 呼叫都提供相同的 claimsRequest 參數)。
claimsRequest 可以指定在 MSALSilentTokenParameters 和 MSALInteractiveTokenParameters中:
/*!
MSALTokenParameters is the base abstract class for all types of token parameters (silent and interactive).
*/
@interface MSALTokenParameters : NSObject
/*!
The claims parameter that needs to be sent to authorization or token endpoint.
If claims parameter is passed in silent flow, access token will be skipped and refresh token will be tried.
*/
@property (nonatomic, nullable) MSALClaimsRequest *claimsRequest;
@end
MSALClaimsRequest 可根據 JSON Claims 要求的 NSString 表示建立。
Objective-C:
NSError *claimsError = nil;
MSALClaimsRequest *request = [[MSALClaimsRequest alloc] initWithJsonString:@"{\"id_token\":{\"auth_time\":{\"essential\":true},\"acr\":{\"values\":[\"urn:mace:incommon:iap:silver\"]}}}" error:&claimsError];
Swift:
var requestError: NSError? = nil
let request = MSALClaimsRequest(jsonString: "{\"id_token\":{\"auth_time\":{\"essential\":true},\"acr\":{\"values\":[\"urn:mace:incommon:iap:silver\"]}}}",
error: &requestError)
也可以透過提出額外的特定權利要求進行修改:
Objective-C:
MSALIndividualClaimRequest *individualClaimRequest = [[MSALIndividualClaimRequest alloc] initWithName:@"custom_claim"];
individualClaimRequest.additionalInfo = [MSALIndividualClaimRequestAdditionalInfo new];
individualClaimRequest.additionalInfo.essential = @1;
individualClaimRequest.additionalInfo.value = @"myvalue";
[request requestClaim:individualClaimRequest forTarget:MSALClaimsRequestTargetIdToken error:&claimsError];
Swift:
let individualClaimRequest = MSALIndividualClaimRequest(name: "custom-claim")
let additionalInfo = MSALIndividualClaimRequestAdditionalInfo()
additionalInfo.essential = 1
additionalInfo.value = "myvalue"
individualClaimRequest.additionalInfo = additionalInfo
do {
try request.requestClaim(individualClaimRequest, for: .idToken)
} catch let error as NSError {
// handle error here
}
MSALClaimsRequest 接著應該在代幣參數中設定,並提供給其中一個 MSAL 代幣取得 API:
Objective-C:
MSALPublicClientApplication *application = ...;
MSALWebviewParameters *webParameters = ...;
MSALInteractiveTokenParameters *parameters = [[MSALInteractiveTokenParameters alloc] initWithScopes:@[@"user.read"]
webviewParameters:webParameters];
parameters.claimsRequest = request;
[application acquireTokenWithParameters:parameters completionBlock:completionBlock];
Swift:
let application: MSALPublicClientApplication!
let webParameters: MSALWebviewParameters!
let parameters = MSALInteractiveTokenParameters(scopes: ["user.read"], webviewParameters: webParameters)
parameters.claimsRequest = request
application.acquireToken(with: parameters) { (result: MSALResult?, error: Error?) in ...