Apple TV Authentication Context

Authentication Context는 인증 UI를 제공하고 ID 제공자 서버와 커뮤니케이션을 통해서 사용자의 자격 증명 정보를 인증하는 웹 서비스입니다 이는 Apple TV Distribution Program의 일환으로 iOS와 tvOS 기기에서 TV Provider를 위한 single sign-on 기능을 받기 위해서 거쳐야 할 여러 단계 중 하나입니다 Authentication Context는 사용자의 서버가 호스트하는 웹서비스로 Apple 기기에 다운로드되어 런타임에 실행됩니다 Authentication Context가 인증 반응을 통과해 VideoSubscriberAccount Framework로 넘어갈 때 기기 키체인에 저장이 됩니다 iOS 기기에서 인증반응은 iCloud Keychain을 통해서 다른 iOS 기기들과 동기화가 가능합니다 그리고 tvOS가 iCloud Keychain을 지원하지 않기 때문에 Apple TV에서는 인증 반응이 기기를 벗어나지 않습니다 Authentication Context의 목적은 지원되는 앱의 전반에 걸쳐 OS-level 인증을 검증하는 것입니다 이 과정의 첫 단계는 개인에게 UI를 위한 인증을 제시하여 그들의 자격 인증 정보를 입력하게끔 하는 것입니다 입력된 자격 인증 정보의 UI를 명시하기 위해서는 인증 Template을 이용합니다 이는 Apple(DNT)가 제공하는 문서에 나온 예시들과 유사한 XML 문서입니다 Apple(DNT)측에 XML을 제공하면 그 사용자가 이용하는 플랫폼에 따라 Apple system UI 처럼 보이게 만듭니다 예를 들어, 여기의 디폴트 아이디와 비밀번호 템플릿은 iOS와 tvOS 기기에 모두 적용할 수 있습니다 autoAthenticationTemplate은 사용자에게 자격 인증 정보를 요청하지 않습니다 대신, 사용자에게 어떤 계정이 자동으로 인증 되는지 알려주고 수동으로 다른 계정으로 로그인 할 수 있는 옵션을 제공합니다 이 템플릿 역시 iOS와 tvOS 기기 모두 적용이 가능합니다 만약 사용자로부터 자격 인증 정보를 직접 받지 못할 경우, 대체 템플릿을 제공합니다 onscreenCodeAuthenticationTemplate은 tvOS에만 적용됩니다 개인이 전화, 타블릿 pc 또는 컴퓨터 등의 다른 기기의 웹브라우저에 입력할 on-screen code를 표시합니다 이 webAuthenticationTemplate은 iOS 기기에만 적용됩니다 명시된 URL을 사용해 웹뷰를 실행합니다 Authentication Context와 런칭된 웹뷰 사이의 커뮤니케이션을 위해서 VideoSubscriberAccount class를 이용합니다 시작하기 위해서는 JavaScript를 이용해 Authentication Context를 만들고 XML 템플릿으로 인증 UI를 정의합니다 이 JavaScript 파일을 서버에 호스팅합니다 Authentication Context는 하나만 써야하는것이 중요한데 같은 것을 두개의 기기에 모두 사용할 수 있기 때문입니다 마지막으로 Context와 XML을 모두 쓴 후에 TV Provider onboarding 데이터를 Apple(DNT)에 보냅니다 이 데이터에는 TV Provider를 위한 Apple(DNT) UI에 표시될 이름과 TV Provider를 위한 identifier가 포함되는데 이는 Apple(DNT) 시스템에서 TV Provider를 타사와 구별하기 위해 사용되고 인증된 URL은 TV Provider 서버를 확인하기 위해 사용되며 Authentication Context 기기에 접속하고 다운로드할 때 필요합니다 TV Provider 브랜드에 표시될 아트워크를 App Store UI를 통해서 Apple(DNT)에 보냅니다 아트워크에 대한 자세한 사항은 제공된 Apple(DNT) 문서를 참고하시기 바랍니다 지원채널 목록을 보냅니다 이것은 선택적인 onboarding 데이터입니다 여기에서 채널은 TV Provider가 지원하는 앱을 참조합니다 Apple TV Distribution Program 에서는 인증 flow 이후에 자동으로 앱이 하나 설치됩니다 이것은 메인 앱입니다 TV Provider 자격 인증 정보를 이용한 추가적인 앱이 있다면 이 목록을 이용해서 고객에게 TV Provider가 지원하는 다른 앱을 제시합니다 Authentication Context를 개발하기 시작하려면 VideoSubscriberAccountFramework로부터 Authentication Context로 보내진 콜백 요청을 처리해야 합니다 첫번째는 onLaunch입니다 이것은 Video Subscriber Account 목록에서 TV Provider를 선택한 다음에 어떤 일이 일어나는지 보여줍니다 TV Provider를 선택한 후에 다음 콜백이 있을때까지 대기 화면이 나타납니다 onShowUserInterface에 관해 설명드리겠습니다 자격 인증 정보를 입력하기 위해 인증 템플릿이 나타나도록 콜백을 처리해야 합니다 다음은 onRequest에 관한 것인데 자격 인증 정보가 입력된 후에는 그 정보를 즉시 ID 제공 서버로 보냅니다 이 자격 인증 정보는 기기에 저장되지 않습니다 인증 응답이 서버로부터 다시 Authentication Context로 다음은 VideoSubscriberAccountFramework로 보내지는데 이는 시스템 레벨의 인증을 구축하기 위함입니다 앱 레벨의 인증 요청은 시스템 레벨 인증이 유효할시에만 프로세싱을 위해서 보내집니다 어플리케이션 디버깅을 위해서는 iOS와 tvOS 기기에서 Developer Mode를 실행하여 코드가 활성화되기 전에 TV Provider를 추가하고 테스트합니다 특히 Authentication Context의 디버깅하기 위해서는 Safari Web Inspector를 사용합니다 Web Inspector를 반드시 기기에서 실행하여 MacOS 기기에서 JavaScript 디버깅을 해야합니다 요약하면 Authentication Context는 JavaScript를 바탕으로 한 웹서비스로 VideoSubscriberAccount Framework 내에서 TV Provider를 위해 ID 제공 서버간의 커뮤니케이션을 촉진시킵니다 감사힙니다