오류 보고 error-reporting

개요 overview

Adobe Pass 인증의 오류 보고는 현재 두 가지 방법으로 구현됩니다.

고급 오류 보고 advanced-error-reporting

AccessEnabler JavaScript SDK accessenabler-javascript-sdk

새 오류 보고 시스템은 선택 사항으로 남아 있으므로 구현자는 오류 처리기 콜백을 명시적으로 등록하여 고급 오류 보고서를 수신할 수 있습니다. 이 시스템에는 여러 오류 콜백을 동적으로 등록 및 등록 취소할 수 있는 기능이 포함되어 있습니다. 또한 AccessEnabler JavaScript SDK가 로드되면 다른 초기화를 수행하지 않아도(setRequestor() 호출 전) 새 오류 콜백을 등록할 수 있습니다. 즉, 초기화 및 구성 오류에 대한 고급 보고서를 수신할 수 있습니다.

구현 access-enab-js-imp

yourErrorHandler(errorData:Object)

오류 처리기 콜백 함수는 다음 구조의 단일 개체(맵)를 수신합니다.

    {
      errorId: "CFG410",
      level: "error",
      message: "This a fancy message",  // Optional
      .
      .                                 // Optional key/value pairs
      .
    }

1. 바인딩 bind

.bind(eventType:String, handlerName:String):void

이벤트에 대한 핸들러를 연결합니다.

eventType - "errorEvent" 값만 사용하면 AccessEnabler JavaScript SDK에서 고급 오류 보고서 콜백을 트리거할 수 있습니다.

handlerName - 오류 처리기 함수의 이름을 지정하는 문자열입니다.

두 바인드 매개 변수 모두 [0-9a-zA-Z][-._a-zA-Z0-9] 집합의 문자만 사용해야 합니다. 즉, 매개 변수는 숫자나 문자로 시작해야 하며 하이픈, 마침표, 밑줄 및 영숫자만 포함할 수 있습니다. 또한 매개 변수는 1,024자를 초과할 수 없습니다.

바인딩 오류 처리기의 예:

accessEnabler.bind('errorEvent', 'myCustomErrorHandler');
accessEnabler.bind('errorEvent', 'errorLogger');

기술적 한계로 인해 닫힘이나 익명 함수를 바인딩할 수 없습니다. 두 번째 매개 변수에서 메서드의 이름을 지정해야 합니다.

2. 바인딩 해제 unbind

.unbind(eventType:String, handlerName:String=null):void

이전에 첨부된 이벤트 처리기를 제거합니다.

eventType - 'errorEvent' 값만 사용하면 AccessEnabler JavaScript SDK에서 고급 오류 보고서 콜백을 트리거할 수 있습니다.

handlerName - 이 null이거나 지정된 eventType에 연결된 모든 처리기가 누락된 경우 오류 처리기 함수의 이름을 지정하는 문자열이 제거됩니다.

두 바인드 매개 변수 모두 [0-9a-zA-Z][-._a-zA-Z0-9] 집합의 문자만 사용해야 합니다. 즉, 매개 변수는 숫자나 문자로 시작해야 하며 하이픈, 마침표, 밑줄 및 영숫자만 포함할 수 있습니다. 또한 매개 변수는 1,024자를 초과할 수 없습니다.

단일 오류 처리기를 제거하는 예:

accessEnabler.unbind('errorEvent', 'errorLogger');

예 모든 오류 처리기를 제거하는 중:

accessEnabler.unbind('errorEvent');

AccessEnabler iOS/tvOS SDK accessenabler-ios-tvos-sdk

새 오류 보고 시스템은 필수 항목이므로 구현자는 새 목표 C "EntitlementStatus" 프로토콜을 명시적으로 준수해야 합니다. 이 새로운 접근 방식을 통해 프로그래머는 고급 오류 보고를 받을 수 있습니다.

구현 accessenab-ios-tvossdk-imp

구현자는 다음 EntitlementStatus 프로토콜을 준수해야 합니다.

EntitlementStatus.h

    #import <Foundation/Foundation.h>

    @protocol EntitlementStatus <NSObject>
    - (void)status:(NSDictionary *)statusDictionary;
    @end

status 함수는 다음 구조의 단일 개체(NSDictionary)를 받습니다.

    {
          errorId: "CFG410",
          level: "error",
          message: "This a fancy message",  // Optional
      .
      .                                 // Optional key/value pairs
      .
    }

1. 선언

    @interface MyEntitlementStatusDelegate : NSObject <EntitlementStatus>

2. 구현

    @implementation DemoAppAppDelegate
    // very simple implementation
    - (void)status:(NSDictionary *)statusDict {
        NSLog(@"%@:\n%@", statusDict[@"level"], statusDict);
    }

AccessEnabler Android SDK accessenabler-android-sdk

구현자는 IAccessEnablerDelegate 인터페이스 정의 프로토콜을 명시적으로 준수해야 하므로 새 오류 보고 시스템은 필수입니다. 이 새로운 접근 방식을 통해 프로그래머는 고급 오류 보고를 받을 수 있습니다.

구현 access-enablr-androidsdk-imp

구현자는 IAccessEnablerDelegate 인터페이스에서 새 status 메서드를 처리해야 합니다. status 함수는 다음 모델이 있는 단일 AdvancedStatus 개체를 수신합니다.

    class AdvancedStatus {

    String id; // Not Null
    String level; // Not Null
    String message; // Might be null
    String resource; // Might be null

    AdvancedStatus(String id, String level, String message, String resource) {
        this.id = id;
        this.level = level;
        this.message = message;
        this.resource = resource;
    }

    //other private/public methods
    }

샘플

    @Override
    public void status(AdvancedStatus advancedStatus) {
        String status = "status(" + advancedStatus.id + ", " + advancedStatus.level + ", " + advancedStatus.message + ", " + advancedStatus.resource + ")";

        Log.i(LOG_TAG, status);
    }

AccessEnabler Fireos SDK accessenabler-fireos-sdk

구현자는 IAccessEnablerDelegate 인터페이스 정의 프로토콜을 명시적으로 준수해야 하므로 새 오류 보고 시스템은 필수입니다. 이 새로운 접근 방식을 통해 프로그래머는 고급 오류 보고를 받을 수 있습니다.

구현 access-enab-fireos-sdk-

구현자는 IAccessEnablerDelegate 인터페이스에서 새 status메서드를 처리해야 합니다. status 함수는 다음 모델이 있는 단일 AdvancedStatus 개체를 수신합니다.

    class AdvancedStatus {

    String id; // Not Null
    String level; // Not Null
    String message; // Might be null
    String resource; // Might be null

    AdvancedStatus(String id, String level, String message, String resource) {
        this.id = id;
        this.level = level;
        this.message = message;
        this.resource = resource;
    }

    //other private/public methods
    }

샘플

    @Override
    public void status(AdvancedStatus advancedStatus) {
        String status = "status(" + advancedStatus.id + ", " + advancedStatus.level + ", " + advancedStatus.message + ", " + advancedStatus.resource + ")";

        Log.i(LOG_TAG, status);
    }

고급 오류 코드 참조 advanced-error-codes-reference

다음 표에는 최신 오류 API에 의해 노출된 오류 코드와 이를 수정하기 위해 취해야 할 제안 작업이 나열되고 설명되어 있습니다.

원래 오류 보고 original-error-reporting

이 섹션에서는 원래 오류 코드와 함께 원래 오류 보고 시스템에 대해 설명합니다. 원래 오류 보고 시스템에서 AccessEnabler는 checkAuthentication() 호출 후 setAuthenticationStatus(), checkAuthorization() 또는 getAuthorization() 호출 실패 후 tokenRequestFailed() 두 콜백 함수에 오류를 전달합니다.

원래 오류 보고 및 상태 API는 이전과 동일하게 계속 작동합니다. 그러나 앞으로는 원래 오류 보고 API가 업데이트되지 않습니다. 이전 오류에 대한 새 오류 보고와 업데이트는 모두 새 고급 오류 보고 시스템에서만 반영됩니다.

원래 오류 보고 시스템을 사용하는 예는 JavaScript API 참조:setAuthenticationStatus() 및 tokenRequestFailed() 함수, iOS/tvOS API 참조: setAuthenticationStatus() 및 tokentRequestFailed(), Android API 참조: setAuthenticationStatus() 및 tokenRequestFailed()을 참조하십시오.

원래 콜백 오류 코드 original-callback-error-codes