Navigation SDK for iOS | Google for Developers

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Firebase 앱 체크는 합법적인 앱 이외의 소스에서 발생하는 트래픽을 차단하여 앱에서 Google Maps Platform으로의 호출을 보호합니다. 이를 위해 App Attest와 같은 증명 프로바이더에게 앱 또는 기기의 신뢰성 평가를 요청합니다. 앱을 앱 체크와 통합하면 악성 및 승인되지 않은 요청으로부터 보호할 수 있으며, 이는 승인되지 않은 청구로부터 결제를 보호하는 데 도움이 됩니다. 또한 App Check는 차량 앱 생태계에서 실시간 중단 보고를 크게 개선하여 앱을 사용하는 모든 운전자에게 이점을 제공합니다. 자세한 내용은 중단 보고를 참고하세요.

앱 체크를 사용해야 하는 이유

App Check는 iOS용 Navigation SDK의 두 가지 영역(기본 탐색 기능 및 중단 보고)을 보호합니다.

앱 체크는 악성 또는 승인되지 않은 소스의 iOS용 기본 Navigation SDK 요청을 차단하는 데 도움이 됩니다. 이렇게 하면 결제 사기 및 할당량 소진으로부터 프로젝트를 보호하여 직접적인 이점을 얻을 수 있습니다.

중단 신고

앱이 실시간 중단 보고 및 투표 기능을 지원하는 경우 앱 체크를 사용하는 것이 좋습니다. App Check를 사용 설정하면 모든 실시간 피드백을 고려한 가장 정확한 경로가 운전자에게 제공됩니다.

보고에 App Check가 중요한 이유:

폐쇄에 대한 높은 신뢰 기준: 도로 폐쇄와 같이 경로에 영향을 미치는 이벤트는 모든 운전자의 라우팅 동작을 크게 바꿀 수 있습니다. 지도를 잠재적인 반달리즘, 스팸 또는 부정확한 신고로부터 보호하기 위해 Google의 도로 폐쇄 중단 조정 인프라는 강력한 기기 및 앱 무결성 신호를 사용합니다.
App Check에서 신고를 검증하는 방법: iOS용 Navigation SDK에서 전송된 사용자 신고 및 투표에는 App Check 토큰이 포함되어 있습니다. 이 토큰은 Google 백엔드에서 피드백의 적법성을 검증하는 데 사용되므로 신뢰 수준이 높아지고 라이브 지도에 미치는 영향을 평가할 수 있습니다.
앱 체크를 생략할 경우의 영향: 유효한 앱 체크 토큰 없이 제출된 보고서는 신뢰도가 낮은 모델에 따라 평가되며 무음 신호로만 처리될 수 있습니다. 즉, 사용자는 계속 신고하고 투표할 수 있지만 신고가 지도에 표시되거나 다른 운전자의 경로에 영향을 미칠 가능성이 낮으며 추가 검증이 필요합니다.

앱 체크가 적합한가요?

대부분의 경우 앱 체크가 권장되지만 다음 시나리오에서는 앱 체크가 필요하지 않거나 지원되지 않습니다.

비공개 또는 실험용 앱: 앱에 공개적으로 액세스할 수 없는 경우 앱 확인이 필요하지 않습니다.
보안 침해된 기기: 권장 증명 제공자는 루팅 또는 탈옥된 휴대전화와 같이 신뢰할 수 없는 기기에서 iOS용 Navigation SDK가 실행되지 않도록 합니다. 이러한 기기를 지원하려면 맞춤 증명 프로바이더를 배포하세요.

구현 단계 개요

대략적으로 앱을 앱 확인과 통합하려면 다음 단계를 따르세요.

앱에 Firebase를 추가합니다.
앱 체크 라이브러리를 추가하고 앱 체크를 초기화합니다.
토큰 제공업체를 추가합니다. 이 단계에서는 선택한 증명 프로바이더를 호출하여 기기 또는 앱의 무결성을 확인합니다.
Navigation 및 App Check API를 초기화합니다.
디버깅을 사용 설정합니다. 이는 개발 중이나 지속적 통합 (CI) 환경에서 유용합니다.
강제 시행을 사용 설정하기 전에 앱 요청을 모니터링하세요. 이렇게 하면 사용자를 방해하지 않고 원활하게 앱 확인을 시행할 수 있습니다.

앱 체크 통합을 계획할 때 고려사항

증명 제공자 할당량: Google에서 권장하는 증명 제공자인 DeviceCheck 또는 App Attest에는 Apple에서 설정한 할당량 및 제한이 적용됩니다.
시작 지연 시간: 대부분의 경우 앱 체크 토큰이 기기에 캐시되므로 사용자는 일반적인 사용 중에 지연 시간을 경험하지 않습니다. 시스템은 만료되기 전에 백그라운드에서 앱 체크 토큰을 자동으로 새로고침하여 원활한 성능을 유지합니다. 하지만 유효한 앱 체크 토큰이 없으면 앱 사용자가 시작 시 지연 시간을 경험하게 됩니다. 예를 들어 캐시된 토큰이 만료되었거나 누락된 콜드 스타트 중에 이 지연 시간이 발생합니다.
토큰 TTL: 수명 (TTL)은 앱 체크 토큰을 새로고침해야 하기 전까지 유효한 시간을 결정합니다. Firebase Console에서 이 기간을 30분에서 7일 사이로 구성할 수 있습니다. 1시간의 기간이 안전한 기준선으로 권장되지만 SDK는 TTL 기간의 약 절반에서 백그라운드 새로고침을 자동으로 시도합니다. 단계별 콘솔 안내는 Firebase 앱 체크 문서를 참고하세요.

앱을 앱 체크와 통합

기본 요건 및 요구사항

iOS용 Navigation SDK 버전 11.0 이상이 설치된 앱
앱의 번들 ID입니다.
Apple Developer Console의 Membership(멤버십) 탭에 있는 팀 ID입니다.
DeviceCheck를 사용하려는 경우 비공개 키 파일 및 키 ID
Google Cloud 콘솔에서 앱의 소유자여야 합니다.
Google Cloud 콘솔의 앱 프로젝트 ID입니다.

1단계: 앱에 Firebase 추가

Firebase 개발자 문서의 안내에 따라 앱에 Firebase를 추가합니다. 수정하지 않은 GoogleService-Info.plist 파일을 프로젝트의 루트 수준에 추가합니다.

AppDelegate 파일에서 다음 모듈을 가져옵니다.

Swift

import FirebaseCore
import FirebaseAppCheck
import GoogleNavigation

Objective-C

@import FirebaseCore;
@import FirebaseAppCheck;
@import GoogleNavigation;

2단계: 앱 체크 라이브러리 추가 및 앱 체크 초기화

Firebase는 각 기본 증명 제공업체에 대한 안내를 제공합니다. 이 안내에서는 Firebase 프로젝트를 설정하고 앱에 앱 확인 라이브러리를 추가하는 방법을 보여줍니다. 제공된 코드 샘플에 따라 앱 확인을 초기화하세요.

Firebase 안내에 따라 앱 체크 라이브러리를 추가합니다.
- App Attest 안내
- DeviceCheck 안내

AppDelegate에서 앱 체크를 초기화합니다.

App Attest를 사용하는 경우 AppCheckProviderFactory 구현을 만들고 FirebaseApp.configure()를 호출하기 전에 등록하세요.

Swift

class YourAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
    func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
        return AppAttestProvider(app: app)
    }
}
// In application(_:didFinishLaunchingWithOptions:)
let providerFactory = YourAppCheckProviderFactory()
AppCheck.setAppCheckProviderFactory(providerFactory)
FirebaseApp.configure()

Objective-C

#import <FirebaseCore/FirebaseCore.h>
#import <FirebaseAppCheck/FirebaseAppCheck.h>

@interface YourAppCheckProviderFactory : NSObject <FIRAppCheckProviderFactory>
@end

@implementation YourAppCheckProviderFactory
- (nullable id<FIRAppCheckProvider>)createProviderWithApp:(FIRApp *)app {
    return [[FIRAppAttestProvider alloc] initWithApp:app];
}
@end

// In application:didFinishLaunchingWithOptions:
YourAppCheckProviderFactory *providerFactory = [[YourAppCheckProviderFactory alloc] init];
[FIRAppCheck setAppCheckProviderFactory:providerFactory];
[FIRApp configure];

대신 DeviceCheck를 사용하는 경우 다음을 사용하여 팩토리를 설정합니다.

Swift

AppCheck.setAppCheckProviderFactory(DeviceCheckProviderFactory())

Objective-C

FIRDeviceCheckProviderFactory *providerFactory = [[FIRDeviceCheckProviderFactory alloc] init];
[FIRAppCheck setAppCheckProviderFactory:providerFactory];

3단계: 토큰 제공자 추가

앱의 루트 수준에 AppCheckTokenProvider라는 파일을 만듭니다 (Objective-C를 사용하는 경우 AppCheckTokenProvider.h 및 AppCheckTokenProvider.m라는 파일 두 개).

이 클래스는 GMSAppCheckTokenProvider 프로토콜을 준수하고 fetchAppCheckTokenWithCompletion 메서드를 구현해야 합니다.

Swift

import Foundation
import FirebaseAppCheck
import GoogleNavigation

class AppCheckTokenProvider: NSObject, GMSAppCheckTokenProvider {
    func fetchAppCheckToken(completion: @escaping (String?, Error?) -> Void) {
        AppCheck.appCheck().token(forcingRefresh: false) { token, error in
            if let error = error {
                print("App Check Error: \(error)")
                completion(nil, error)
                return
            }
            guard let token = token else {
                completion(nil, NSError(domain: "AppCheck", code: -1, userInfo: [NSLocalizedDescriptionKey: "Token is nil"]))
                return
            }
            print("App Check Token: \(token.token)")
            completion(token.token, nil)
        }
    }
}

Objective-C

// AppCheckTokenProvider.h
#import <Foundation/Foundation.h>
#import <GoogleNavigation/GoogleNavigation.h>

NS_ASSUME_NONNULL_BEGIN

@interface AppCheckTokenProvider : NSObject <GMSAppCheckTokenProvider>
@end

NS_ASSUME_NONNULL_END

// AppCheckTokenProvider.m
#import "AppCheckTokenProvider.h"
#import <FirebaseAppCheck/FirebaseAppCheck.h>

@implementation AppCheckTokenProvider
- (void)fetchAppCheckTokenWithCompletion:(void (^)(NSString * _Nullable token, NSError * _Nullable error))completion {
    [[FIRAppCheck appCheck] tokenForcingRefresh:NO
                                     completion:^(FIRAppCheckToken * _Nullable token, NSError * _Nullable error) {
        if (token) {
            completion(token.token, nil);
        } else {
            completion(nil, error);
        }
    }];
}
@end

iOS용 Navigation SDK를 초기화하고 GMSServices에 토큰 제공자 인스턴스를 등록합니다.

Swift

// In application(_:didFinishLaunchingWithOptions:)
GMSServices.provideAPIKey("YOUR_API_KEY")

// Register your App Check token provider before initializing Navigation SDK for iOS
GMSServices.appCheckTokenProvider = AppCheckTokenProvider()

Objective-C

// In application:didFinishLaunchingWithOptions:
[GMSServices provideAPIKey:@"YOUR_API_KEY"];

// Register your App Check token provider before initializing Navigation SDK for iOS
GMSServices.appCheckTokenProvider = [[AppCheckTokenProvider alloc] init];

5단계: 디버깅 사용 설정 (선택사항)

iOS용 Navigation SDK에 앱 체크가 적용되면 이러한 환경은 유효한 기기로 인정되지 않으므로 iOS용 Navigation SDK에 종속된 앱의 기능이 시뮬레이터나 지속적 통합 (CI) 환경에서 실행되지 않습니다. 개발 및 테스트 중에 이러한 환경에서 앱을 실행하려면 프로덕션 증명 제공자 대신 앱 체크 디버그 제공자를 사용하는 앱의 디버그 빌드를 만들어야 합니다.

AppDelegate에서 디버그 제공자 팩토리를 구성합니다.

Swift

#if targetEnvironment(simulator)
let providerFactory = AppCheckDebugProviderFactory()
#else
let providerFactory = YourAppCheckProviderFactory()
#endif
AppCheck.setAppCheckProviderFactory(providerFactory)

Objective-C

#if TARGET_OS_SIMULATOR
id<FIRAppCheckProviderFactory> providerFactory = [[FIRAppCheckDebugProviderFactory alloc] init];
#else
id<FIRAppCheckProviderFactory> providerFactory = [[YourAppCheckProviderFactory alloc] init];
#endif
[FIRAppCheck setAppCheckProviderFactory:providerFactory];

Xcode 프로젝트에서 로깅을 사용 설정하고 앱을 실행한 후 콘솔 로그에서 로컬 디버그 토큰을 찾습니다.
이 디버그 토큰을 복사하여 Firebase Console에 추가합니다. 자세한 내용은 Firebase 앱 체크 디버그 제공업체 문서를 참고하세요.

6단계: 앱 요청 모니터링 및 시정 조치 결정

적용을 사용 설정하기 전에 앱 요청을 모니터링하여 정당한 사용자를 방해하지 않는지 확인하세요.

Firebase Console의 앱 체크 측정항목 화면에서 인증된 트래픽과 인증되지 않은 트래픽의 비율을 확인하세요.
대부분의 트래픽이 인증되고 적법한 사용자가 앱 체크 구현이 포함된 앱 버전으로 업데이트되었는지 확인한 후 시행을 사용 설정하세요.
적용이 사용 설정되면 앱 체크에서 유효한 앱 체크 토큰이 없는 모든 트래픽을 거부합니다.

앱 확인을 사용하여 iOS용 Navigation SDK 보안

앱 체크를 사용해야 하는 이유

탐색

중단 신고

앱 체크가 적합한가요?

구현 단계 개요

앱 체크 통합을 계획할 때 고려사항

앱을 앱 체크와 통합

기본 요건 및 요구사항

1단계: 앱에 Firebase 추가

Swift

Objective-C

2단계: 앱 체크 라이브러리 추가 및 앱 체크 초기화

Swift

Objective-C

Swift

Objective-C

3단계: 토큰 제공자 추가

Swift

Objective-C

4단계: Navigation 및 App Check API 초기화

Swift

Objective-C

5단계: 디버깅 사용 설정 (선택사항)

Swift

Objective-C

6단계: 앱 요청 모니터링 및 시정 조치 결정