iOS 앱에 reCAPTCHA Enterprise 통합

이 페이지에서는 iOS 앱에 reCAPTCHA Enterprise를 통합하는 방법을 설명합니다. 휴대기기의 화면 크기, 성능, UI 면에서 차이가 있으므로 모바일 앱에서는 시각적인 reCAPTCHA 챌린지(로봇이 아닙니다)를 사용할 수 없습니다. 다른 완화 방법은 다단계 인증(MFA) 구성을 참조하세요.

시작하기 전에

  1. 환경에서 reCAPTCHA Enterprise를 설정하는 가장 좋은 방법을 선택하고 설정을 완료합니다.

  2. iOS 앱 플랫폼의 reCAPTCHA 키를 만듭니다.

  3. iOS SDK는 보안 검토 후 액세스할 수 있습니다. 이 기능에 사이트를 온보딩하려면 Google 영업팀에 문의하세요.

  4. 영업 담당자에게 요청하여 reCAPTCHA Enterprise CocoaPods 저장소 및 iOS SDK 다운로드 페이지에 대한 액세스 권한을 받으세요.

  5. 개발 환경을 준비하려면 다음 안내를 따르세요.

    • Xcode 최신 버전을 다운로드하여 설치하고 빈 iOS 단일 뷰 애플리케이션을 만듭니다.
    • CocoaPods를 다운로드하여 설치합니다.

    • CocoaPods 또는 다운로드 페이지에서 SDK를 다운로드합니다.

      CocoaPods

      1. git 쿠키를 생성합니다.
      2. Podfile을 만들고 다음 줄을 Podfile에 추가합니다.

        source "https://cpdc-eap.googlesource.com/RecaptchaEnterprise.git"
        source "https://github.com/CocoaPods/Specs.git"
        
        pod "RecaptchaEnterprise", "16.1.0"
        
      3. pod update를 실행하여 필수 종속 항목을 설치합니다.

      직접 다운로드

      iOS SDK 다운로드 페이지에서 SDK 바이너리를 직접 다운로드합니다.

앱 구성

CocoaPods를 사용하면 Swift 또는 Objective-C로 앱을 작성할 수 있습니다. 앱을 구성하려면 다음 안내를 따르세요.

  1. 링커 플래그에 -ObjC가 있는지 확인하려면 타겟 > 빌드 설정 > 전체 > 연결로 이동하여 Other Linker Flags-ObjC가 표시되는지 확인합니다.

  2. 앱이 Swift로 작성된 경우 Objective-C 브리징 헤더를 만들고 다음 가져오기를 포함합니다.

    #import <recaptcha/recaptcha.h>
    

iOS 앱에 reCAPTCHA Enterprise 통합

iOS 앱에 reCAPTCHA Enterprise를 통합하려면 Xcode에서 다음 단계를 따르세요.

  1. 생성된 reCAPTCHA 키로 SDK를 인스턴스화하려면 다음 코드를 사용하여 ViewController를 업데이트하세요.

    Swift

    let recaptchaClient = RecaptchaClient(siteKey: "reCAPTCHA_KEY_iOS")
    

    Objective-C

    RecaptchaClient *recaptchaClient = [[RecaptchaClient alloc] initWithSiteKey:@"reCAPTCHA_KEY_iOS"];
    

  2. reCAPTCHA Enterprise를 호출하고 ViewController에 삽입한 코드를 트리거하는 버튼을 만듭니다.

    1. 스토리보드에서 버튼을 만듭니다.
    2. 만든 버튼에 연결된 ViewController에서 작업을 만듭니다.
    3. 다음 코드 스니펫을 사용하여 execute() 메서드를 호출하여 reCAPTCHA 토큰을 반환합니다.

      Swift

      recaptchaClient.execute(RecaptchaAction(action: .login)) { token, error in
       if let recaptchaToken = token {
              print(recaptchaToken.recaptchaToken)
           }
            if let error = error {
              print(error)
            }
       }
      

      Objective-C

       [recaptchaClient execute: [[RecaptchaAction alloc] initWithAction: RecaptchaActionTypeLogin] onFinishedExecute: ^ (RecaptchaToken * _Nullable token, RCARecaptchaError * _Nullable error) {
      
           if (error) {
               NSLog (@ "% @", error);
           } else {
               NSLog (@ "% @", token);
           }
      
       }];
      
      

  3. 애플리케이션을 테스트합니다.

    1. Xcode 빌드 환경을 삭제하려면 제품 메뉴에서 빌드 폴더 정리를 클릭합니다.
    2. 애플리케이션을 실행하려면 제품 메뉴에서 실행을 클릭합니다.
    3. 로드된 애플리케이션에서 앞에서 만든 reCAPTCHA 버튼을 클릭합니다.
    4. 통합에 성공하면 반환되는 reCAPTCHA 토큰(알파벳-숫자 문자열)의 디버그 출력 창을 관찰합니다.

iOS API 참조

iOS SDK 다운로드 페이지에 대한 액세스 권한을 부여하려면 영업 담당자에게 문의하세요. iOS SDK 다운로드 페이지에서는 reCAPTCHA 개인정보 보호 라벨의 세부정보를 설명합니다.

다음 단계