AppAuth-iOS/Source/AppAuth/visionOS/OIDAuthState+Vision.h at c9520e847f3f699184174f96e5b0421c2d68b0fd · openid/AppAuth-iOS · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
/*! @file OIDAuthState+Vision.h
    @brief AppAuth iOS SDK
    @copyright
        Copyright 2016 Google Inc. All Rights Reserved.
    @copydetails
        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at

        http://www.apache.org/licenses/LICENSE-2.0

        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
 */

#import <TargetConditionals.h>

#if TARGET_OS_VISION

#import <UIKit/UIKit.h>

#import "OIDAuthState.h"

NS_ASSUME_NONNULL_BEGIN

/*! @brief visionOS specific convenience methods for @c OIDAuthState.
 */
@interface OIDAuthState (Vision)

/*! @brief Convenience method to create a @c OIDAuthState by presenting an authorization request
        and performing the authorization code exchange in the case of code flow requests. For
        the hybrid flow, the caller should validate the id_token and c_hash, then perform the token
        request (@c OIDAuthorizationService.performTokenRequest:callback:)
        and update the OIDAuthState with the results (@c
        OIDAuthState.updateWithTokenResponse:error:).
    @param authorizationRequest The authorization request to present.
    @param presentingWindow The window to present the authentication flow.
    @param callback The method called when the request has completed or failed.
    @return A @c OIDExternalUserAgentSession instance which will terminate when it
        receives a @c OIDExternalUserAgentSession.cancel message, or after processing a
        @c OIDExternalUserAgentSession.resumeExternalUserAgentFlowWithURL: message.
 */
+ (id<OIDExternalUserAgentSession>)
    authStateByPresentingAuthorizationRequest:(OIDAuthorizationRequest *)authorizationRequest
                             presentingWindow:(UIWindow *)presentingWindow
                                     completion:(OIDAuthStateAuthorizationCallback)callback;

/*! @brief Convenience method to create a @c OIDAuthState by presenting an authorization request
        (optionally using an emphemeral browser session that shares no cookies or data with the
        normal browser session) and performing the authorization code exchange in the case of code
        flow requests. For the hybrid flow, the caller should validate the id_token and c_hash, then
        perform the token request (@c OIDAuthorizationService.performTokenRequest:callback:)
        and update the OIDAuthState with the results using
        @c OIDAuthState.updateWithTokenResponse:error:.
    @param authorizationRequest The authorization request to present.
    @param presentingWindow The window to present the @c ASWebAuthenticationSession UI.
    @param prefersEphemeralSession Whether the caller prefers to use a private authentication
        session. See @c ASWebAuthenticationSession.prefersEphemeralWebBrowserSession for more.
    @param callback The method called when the request has completed or failed.
    @return A @c OIDExternalUserAgentSession instance which will terminate when it
        receives a @c OIDExternalUserAgentSession.cancel message, or after processing a
        @c OIDExternalUserAgentSession.resumeExternalUserAgentFlowWithURL: message.
 */
+ (id<OIDExternalUserAgentSession>)
    authStateByPresentingAuthorizationRequest:(OIDAuthorizationRequest *)authorizationRequest
                             presentingWindow:(UIWindow *)presentingWindow
                      prefersEphemeralSession:(BOOL)prefersEphemeralSession
                                     completion:(OIDAuthStateAuthorizationCallback)callback;

/*! @param authorizationRequest The authorization request to present.
    @param callback The method called when the request has completed or failed.
    @return A @c OIDExternalUserAgentSession instance which will terminate when it
        receives a @c OIDExternalUserAgentSession.cancel message, or after processing a
        @c OIDExternalUserAgentSession.resumeExternalUserAgentFlowWithURL: message.
    @discussion This method uses the default browser to present the authentication flow.
 */
+ (id<OIDExternalUserAgentSession>)
    authStateByPresentingAuthorizationRequest:(OIDAuthorizationRequest *)authorizationRequest
                                     completion:(OIDAuthStateAuthorizationCallback)callback
    __deprecated_msg("For visionOS 1.0 and above please use "
        "authStateByPresentingAuthorizationRequest:presentingWindow:callback:");

@end

NS_ASSUME_NONNULL_END

#endif // TARGET_OS_OSX