콘텐츠 인증

Classic/VPC 환경에서 이용 가능합니다.

콘텐츠 인증에서는 스크립트 코드를 수정하여 재생 소스에 Secure Token을 적용하는 방법과 MultiDRM을 설정하는 방법을 설명합니다.

Secure Token

token 속성으로 재생 소스에 Secure Token을 적용하여 OneTimeUrl을 지원할 수 있습니다. 또한, player.tokenChange 속성으로 동영상 재생 중 중단 없이 Secure Token을 교체할 수 있습니다.

예제는 다음과 같습니다.

// 동영상(MP4)
new ncplayer('video1', {
  autostart: true,
  playlist: [
    {
      file: 'https://CDN도메인/example_video_01.mp4',
    },
  ],
  token: 'token=st=1675320871~exp=1675320901~acl=....', // Secure Token
});

// 토큰 교체
player.tokenChange('token=st=1675320871~exp=1675320901~acl=....') // 재생 중 신규 토큰으로 교체

MultiDRM

playlist.drm 속성으로 MultiDRM을 설정할 수 있습니다. 예제는 다음과 같습니다.

let player;

document.addEventListener('DOMContentLoaded',  async ()=> {
    await ncplayerDRM('video1',{
        playlist: [
            {
                drm:{
                    'com.apple.fps':{
                        certificateUrl: '{Certificate URL}',
                        licenseUri : 'https://license-global.pallycon.com/ri/licenseManager.do',
                        licenseRequestHeader:{
                            'Content-type': 'application/x-www-form-urlencoded',
                            'pallycon-customdata-v2':'{FairPlay용 Token}'
                        },
                        src : '{hls url}'
                    },
                    'com.widevine.alpha':{
                        licenseUri : 'https://license-global.pallycon.com/ri/licenseManager.do',
                        licenseRequestHeader:{
                            'pallycon-customdata-v2':'{Widevine용 Token}'
                        },
                        src : '{dash url}'
                    },
                    'com.microsoft.playready':{
                        licenseUri : 'https://license-global.pallycon.com/ri/licenseManager.do',
                        licenseRequestHeader:{
                            'pallycon-customdata-v2':'{PlayReady용 Token}'
                        },
                        src : '{dash url}'
                    },
                },
                poster: 'https://nnbkegvqsbcu5297614.cdn.ntruss.com/profile/202207/ae73f3a32b49205fafdc3303c7f0c0b8.png',
                description: {
                    title: "네이버클라우드",
                    create_at: "2022-12-31",
                    profile_name: "Naver Cloud Platform",
                    profile_image: "https://nnbkegvqsbcu5297614.cdn.ntruss.com/profile/202207/ae73f3a32b49205fafdc3303c7f0c0b8.png
                },
            }
        ],
        controlBtn: {
            play: true,
            fullscreen: true,
            volume: true,
            times: true,
            pictureInPicture: true,
            setting: true,
            subtitle: true
        },
        autostart: false
    });
});

One Click Multi DRM

Video Player Enhancement 서비스와 One Click Multi DRM 서비스를 연동하여 DRM을 적용할 수 있습니다.
FPS Certificate 및 라이선스 발급을 요청하기 위한 Endpoint(엔드포인트) 및 요청 헤더를 확인해 주십시오.

• FPS Certificate 요청(Apple FairPlay 전용)
• 라이선스 발급 요청(FairPlay, Widevine, PlayReady 공용)

FPS Certificate 요청(Apple FairPlay 전용)

FPS Certificate를 요청하기 위한 엔드포인트 및 요청 헤더는 다음과 같습니다.

• Endpoint

  GET https://multi-drm.apigw.ntruss.com/api/v1/license/fairplay
  

• 요청 헤더

  항목	필수 여부	설명
  X-NCP-REGION_CODE	O	이용 중인 서비스 리전 코드 한국: KR 싱가포르: SGN 미국: USWN 일본: JPN 홍콩: HK 독일: DEN
  X-NCP-IAM-ACCESS-KEY	O	포털 또는 Sub Account에서 발급받은 Access Key ID
  X-NCP-APIGW-TIMESTAMP	O	1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며, API Gateway 서버와 시간 차가 5분 이상 나는 경우에는 유효하지 않은 요청으로 간주
  X-NCP-APIGW-SIGNATURE-V2	O	Access Key ID 값과 Secret Key로 암호화한 서명으로, HMAC 암호화 알고리즘은 HmacSHA256 사용

라이선스 발급 요청(FairPlay, Widevine, PlayReady 공용)

라이선스 발급을 요청하기 위한 엔드포인트 및 요청 헤더는 다음과 같습니다.

• Endpoint

  POST https://multi-drm.apigw.ntruss.com/api/v1/license
  

• 요청 헤더

  항목	필수 여부	설명
  X-DRM-TOKEN	O	One Click Multi DRM 라이선스 발급에 필수 데이터가 포함된 암호화된 토큰값
  X-NCP-REGION_CODE	O	이용 중인 서비스 리전 코드 한국: KR 싱가포르: SGN 미국: USWN 일본: JPN 홍콩: HK 독일: DEN
  X-NCP-IAM-ACCESS-KEY	O	포털 또는 Sub Account에서 발급받은 Access Key ID
  X-NCP-APIGW-TIMESTAMP	O	1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며, API Gateway 서버와 시간 차가 5분 이상 나는 경우에는 유효하지 않은 요청으로 간주
  X-NCP-APIGW-SIGNATURE-V2	O	Access Key ID 값과 Secret Key로 암호화한 서명으로, HMAC 암호화 알고리즘은 HmacSHA256 사용

예제

One Click Multi DRM 적용을 위한 Apple FairPlay 및 Widevine/PlayReady 예제는 다음과 같습니다.

• Apple FairPlay

  document.addEventListener('DOMContentLoaded',  async ()=> {
      await ncplayerDRM('myElement',{
          playlist: [
              {
                  drm:{
                      'com.apple.fps':{
                          certificateUri: '{FPS Certificate Endpoint}',
                          certificateRequestHeader:{
                              'X-NCP-REGION_CODE': 'KR',
                              'X-NCP-IAM-ACCESS-KEY': accessKey,
                              'X-NCP-APIGW-TIMESTAMP': timestamp,
                              'X-NCP-APIGW-SIGNATURE-V2': signature,		 
                          },
                          licenseUri : '{License Endpoint}',
                          licenseRequestHeader:{
                              'X-DRM-TOKEN': '{One Click Multi DRM FPS TOKEN}',
                              'X-NCP-REGION_CODE': 'KR',
                              'X-NCP-IAM-ACCESS-KEY': accessKey,
                              'X-NCP-APIGW-TIMESTAMP': timestamp2,
                              'X-NCP-APIGW-SIGNATURE-V2': signature2,		 
                          },
                          src : 'http://example.com/index.m3u8'
                      }
                  },
                  poster: 'http://example.com/myVideoThumb.png',
              }
          ],
          autostart: true
      });
  });
  

• Widevine/PlayReady

  document.addEventListener('DOMContentLoaded',  async ()=> {
      await ncplayerDRM('myElement',{
          playlist: [
              {
                  drm:{
                      'com.widevine.alpha':{
                          licenseUri : '{License Endpoint}',
                          licenseRequestHeader:{
                              'X-DRM-TOKEN': '{One Click Multi DRM WIDEVINE TOKEN}',
                              'X-NCP-REGION_CODE': 'KR',
                              'X-NCP-IAM-ACCESS-KEY': accessKey,
                              'X-NCP-APIGW-TIMESTAMP': timestamp2,
                              'X-NCP-APIGW-SIGNATURE-V2': signature2,		 
                          },
                          src : 'http://example.com/index.mpd'
                      },
                      'com.microsoft.playready':{
                          licenseUri : '{License Endpoint}',
                          licenseRequestHeader:{
                              'X-DRM-TOKEN': '{One Click Multi DRM PLAYREADY TOKEN}',
                              'X-NCP-REGION_CODE': 'KR',
                              'X-NCP-IAM-ACCESS-KEY': accessKey,
                              'X-NCP-APIGW-TIMESTAMP': timestamp2,
                              'X-NCP-APIGW-SIGNATURE-V2': signature2,		 
                          },
                          src : 'http://example.com/index.mpd'
                      },
                  poster: 'http://example.com/myVideoThumb.png',
                  }
              }
          ],
          autostart: true
      });
  });
  

DRM 테스트

스크립트 코드를 작성하여 DRM 테스트를 진행할 수 있습니다.

// DRM 전용 스크립트 코드를 이용합니다.
// DOM이 완전히 로드되고 실행해야 DRM이 에러 없이 실행됩니다.
document.addEventListener('DOMContentLoaded',  async ()=> {
    await ncplayerDRM('video1',{});
})

Widevine/PlayReady

Widevine 또는 PlayReady 유형의 DRM을 테스트하는 스크립트는 다음과 같습니다.

document.addEventListener('DOMContentLoaded',  async ()=> {
    await ncplayerDRM('video1',{
        playlist: [
            {
                drm:{
                    'com.widevine.alpha':{
                        licenseUri : 'https://license-global.pallycon.com/ri/licenseManager.do',
                        licenseRequestHeader:{
                            'pallycon-customdata-v2':'{Token}'
                        },
                        src : '{dash url}'
                    },
                    'com.microsoft.playready':{
                        licenseUri : 'https://license-global.pallycon.com/ri/licenseManager.do',
                        licenseRequestHeader:{
                            'pallycon-customdata-v2':'{Token}'
                        },
                        src : '{dash url}'
                    },
                },
                poster: 'https://nnbkegvqsbcu5297614.cdn.ntruss.com/profile/202207/ae73f3a32b49205fafdc3303c7f0c0b8.png',
            }
        ],
    });
});

FairPlay(FPS)

FairPlay 유형의 DRM을 테스트하는 스크립트는 다음과 같습니다.

document.addEventListener('DOMContentLoaded',  async ()=> {
    await ncplayerDRM('video1',{
        playlist: [
            {
                drm:{
                    'com.apple.fps':{
                        certificateUrl: '{Certificate URL}',
                        licenseUri : 'https://license-global.pallycon.com/ri/licenseManager.do',
                        licenseRequestHeader:{
                            'Content-type': 'application/x-www-form-urlencoded',
                            'pallycon-customdata-v2':'{Token}'
                        },
                        src : '{hls url}'
                    },
                },
                poster: 'https://nnbkegvqsbcu5297614.cdn.ntruss.com/profile/202207/ae73f3a32b49205fafdc3303c7f0c0b8.png',
            }
        ],
    });
});