mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-08-02 00:17:02 +00:00
135 lines
4.6 KiB
Objective-C
135 lines
4.6 KiB
Objective-C
//
|
|
// BITAuthenticator_Private.h
|
|
// HockeySDK
|
|
/*
|
|
* Author: Stephan Diederich
|
|
*
|
|
* Copyright (c) 2013 HockeyApp, Bit Stadium GmbH.
|
|
* All rights reserved.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person
|
|
* obtaining a copy of this software and associated documentation
|
|
* files (the "Software"), to deal in the Software without
|
|
* restriction, including without limitation the rights to use,
|
|
* copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the
|
|
* Software is furnished to do so, subject to the following
|
|
* conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be
|
|
* included in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
|
|
* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
|
|
* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
|
|
* WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
|
|
* OTHER DEALINGS IN THE SOFTWARE.
|
|
*/
|
|
|
|
|
|
#import "BITAuthenticator.h"
|
|
#import "BITHockeyBaseManagerPrivate.h"
|
|
#import "BITAuthenticationViewController.h"
|
|
@class BITHockeyAppClient;
|
|
|
|
@interface BITAuthenticator ()<BITAuthenticationViewControllerDelegate>
|
|
|
|
/**
|
|
* must be set
|
|
*/
|
|
@property (nonatomic, strong) BITHockeyAppClient *hockeyAppClient;
|
|
|
|
//can be set for testing
|
|
@property (nonatomic) UIDevice *currentDevice;
|
|
|
|
/**
|
|
* if set, this serves as the installationIdentifier.
|
|
* This is retrieved from the hockeyApp backend
|
|
* @see installationIdentifier
|
|
*/
|
|
@property (nonatomic, readonly) NSString *authenticationToken;
|
|
|
|
/**
|
|
* store the authentication token with the given type
|
|
* if authToken is not nil, authentikationTokenType must also be non nil
|
|
*/
|
|
- (void)setAuthenticationToken:(NSString *)authenticationToken withType:(NSString*) authenticationTokenType;
|
|
|
|
/**
|
|
* holds the identifier of the last version that was authenticated
|
|
* only used if validation is set BITAuthenticatorValidationTypeOnFirstLaunch
|
|
*/
|
|
@property (nonatomic, copy) NSString *lastAuthenticatedVersion;
|
|
|
|
@property (nonatomic, copy) tAuthenticationCompletion authenticationCompletionBlock;
|
|
|
|
/**
|
|
* Specifies the type of installation identification for the current app installation
|
|
*/
|
|
@property (nonatomic, readonly) NSString *installationIdentificationType;
|
|
|
|
/**
|
|
* removes all previously stored authentication tokens, UDIDs, etc
|
|
*/
|
|
- (void) cleanupInternalStorage;
|
|
|
|
@property (nonatomic, readwrite) BOOL installationIdentificationValidated;
|
|
|
|
/**
|
|
* method registered as observer for applicationWillBecomeInactive events
|
|
*/
|
|
- (void) applicationWillResignActive:(NSNotification*) note;
|
|
|
|
/**
|
|
* method registered as observer for applicationsDidBecomeActive events
|
|
*/
|
|
- (void) applicationDidBecomeActive:(NSNotification*) note;
|
|
|
|
/**
|
|
* once the user skipped the optional login, this is set to YES
|
|
* (and thus the optional login should never be shown again)
|
|
* persisted to disk. Defaults to NO
|
|
*/
|
|
@property (nonatomic, assign) BOOL didSkipOptionalLogin;
|
|
|
|
#pragma mark - Authentication
|
|
/**
|
|
* Authenticate this app installation
|
|
*
|
|
* Depending on 'authenticationType', this tries to authenticate the app installation
|
|
* against the HockeyApp server.
|
|
* You should not need to call this, as it's done automatically once the manager has
|
|
* been started, depending on validationType.
|
|
*
|
|
* @param completion if nil, success/failure is reported via the delegate, if not nil, the
|
|
* delegate methods are not called.
|
|
*/
|
|
- (void) authenticateWithCompletion:(tAuthenticationCompletion) completion;
|
|
|
|
#pragma mark - Internal Auth callbacks
|
|
- (void) didAuthenticateWithToken:(NSString*) token;
|
|
|
|
#pragma mark - Validation
|
|
/**
|
|
* Validate the app installation
|
|
*
|
|
* Depending on @see validationType, this is called by the manager after the app becomes active
|
|
* and tries to revalidate the installation.
|
|
* You should not need to call this, as it's done automatically once the manager has
|
|
* been started, depending on validationType.
|
|
*
|
|
* @param completion if nil, success/failure is reported via the delegate, if not nil, the
|
|
* delegate methods are not called
|
|
*/
|
|
- (void) validateInstallationWithCompletion:(tValidationCompletion) completion;
|
|
|
|
|
|
#pragma mark - Validation callbacks
|
|
- (void) validationSucceededWithCompletion:(tValidationCompletion) completion;
|
|
- (void) validationFailedWithError:(NSError *) validationError completion:(tValidationCompletion) completion;
|
|
|
|
@end
|