 |
 |
| |
This method uses a Web service from PlayStream which will return a
license string for you to deliver to your End User and allow you to consume the
PlayStream Web service from your Web server. Using this method allows you to
pre-license your End Users for access to encrypted media. This method also
allows you to deliver licenses only as needed to your End User.
For security purposes, the request to consume the Web service must come from a
registered IP address. You register the IP address(es) that are allowed to
consume the Web service in the PlayStream Account.
You will send the content ID you want the license for, the subscription ID
indicating the rules of the license, your End User’s player info and your
secret GUID. The Web service is located at
https://www.playstream.com/license/DRMLicense.asmx.
To get your End User’s player information, you need to embed an ActiveX control
that will retrieve the player information and then post it to you. When you
retrieve the license string from the Web service, you install it on the End
User’s computer using another ActiveX control.
The example code is available for download here. Click on the "Manage IP/s"
button to add and remove IP's allowed to use the Web service for your DRM
licenses and view your secret GUID.
|
| |
 |
|
| PROCESS SUMMARY |
|
-
The End User hasn't been licensed to play the content.
-
The End User selects the content for which he/she wants to be licensed.
-
The PlayStream Customer uses an ActiveX control to get the End User client
information.
-
The PlayStream Customer's Web server calls the getLicense method by consuming
the PlayStream Web service.
-
The PlayStream Customer returns the license to the End User.
-
The PlayStream Customer directs the End User to the content.
|
| STEP BY STEP INSTRUCTIONS |
|
|
If you have an on-demand account, all instructions assume that you have encoded
and uploaded your media to your account at playstream.com. |
|
|
|
|
|
|
| |
|
|
| Step 1 - Encrypt your media |
|
| Encryption is the act of protecting your media with a unique ID
for purposes data security. In order to access encrypted media, the -End User
must have a User Name and password (Permission) that allows decryption and
playback. Without this Permission, encrypted media will not play. |
| |
|
|
|
|
| Step 2 - Create a Subscription |
| What is a Subscription? |
|
| A Subscription is a combination of media (your files) and Permissions (User
Names and passwords) that are used to control access to your encrypted media. |
|
| How to create a Subscription: |
|
-
Login into your PlayStream account at www.playstream.com using your PlayStream
Customer Login and Password.
-
Click on the “Secure Your Media” icon.
-
Click “View” under the heading “Subscription/Permissions."
-
Click “Create New."
-
Enter a Subscription Name.
-
Leave all the basic rights set to their default values. Scroll down to the
bottom of the page and click “Create New Subscription.”
-
Scroll down to the bottom of the page, and click “Back."
-
If your Subscription does not appear in the Subscription list, click “Refresh”
on your browser.
|
|
|
|
| Step 3 - Register IP Addresses |
| How To Register IP Addresses: |
|
-
Login into your PlayStream account at www.playstream.com using your PlayStream
Customer Login and Password.
-
Click on the “Secure Your Media” icon.
-
Click “View” under the heading “License Acquisition/Delivery."
-
Scroll down and click “Manage IP/s.”
-
Enter an IP Address in the text field at the top of the page.
-
Click “Add IP.”
-
Repeat as necessary.
-
Click “Back” to be returned to the License Acquisition/Delivery.
|
|
|
|
| Step 4 - Authorize End Users
|
| How you authorize, distribute and bill your End Users for permissions (User
Names and passwords) is your choice. PlayStream is currently working with third
party vendors to integrate our DRM services and provide you with a billing
solution. |
|
| |
|
|
| Step 5 - Retrieve the Client Player
information using an embedded ActiveX control and post to your Web server |
| Use the sample code below to retrieve the end End User client information. |
|
<html>
<head>
<SCRIPT LANGUAGE="JavaScript">
<!--
function doSubmit()
{
document.predeliver.clientinfo.value = netobj.GetSystemInfo();
document.predeliver.DRMVersion.value = netobj.GetDRMVersion();
document.predeliver.DRMSecurityVersion.value = netobj.GetDRMSecurityVersion();
document.predeliver.submit();
}
</SCRIPT>
</head>
<body onload="doSubmit()">
<OBJECT classid=clsid:A9FC132B-096D-460B-B7D5-1DB0FAE0C062 height=0
id=netobj width=0 VIEWASTEXT>
</OBJECT>
<form name="predeliver" action="yourinfopage.html" method="post">
<INPUT type="hidden" name="clientinfo" >
<INPUT type="hidden" name="DRMVersion" >
<INPUT type="hidden" name="DRMSecurityVersion" >
</form>
</body>
< /html>
|
|
| |
|
|
| Step 6 - Call the getLicense method by
consuming the PlayStream Web service |
| Example: Classic ASP Code to call the getLicense method |
| |
<%
Dim sCid, iSid, , sGuid
sCid= “TheContentID”
iSid= "TheSubscriptionID"
sCinfo= "<CLIENTINFO><CLIENTID>TheClientIDRetrievedFromTheEndEnd
User</CLIENTID><CLIENTVERSION>TheClientVersionRetrievedFromTheEndEnd
User</CLIENTVERSION><SECURITYVERSION>TheDRMSecurityVersionRetrieved
FromTheEndEnd
User</SECURITYVERSION><APPSECURITY>AppSecurityRetrievedFromTheEndEnd
User</APPSECURITY><SUBJECTID1>TheSubjectIDRetrievedFromTheEndEnd
User</SUBJECTID1><SUBJECTID2></SUBJECTID2><DRMKVERSION>TheDRMKVersion
RetrievedFromTheEndEnd User</DRMKVERSION></CLIENTINFO>"
sGuid = "YourPlayStreamDRMGUID"
Response.Write getLicense(sCid, iSid, sCinfo, sGuid)
Function getLicense(cid, sid, cinfo, guid)
Dim soapClient
Set soapClient = Server.CreateObject("MSSOAP.SoapClient")
soapClient.ClientProperty("ServerHTTPRequest") = True
soapClient.mssoapinit "http://www.playstream.com/license/DRMLicense.asmx?wsdl"
getLicense = soapClient.getLicense(cid, sid, cinfo, guid)
End Function
%>
|
|
| |
|
|
| Step 7 - Deliver the license to the End
User using an embedded ActiveX control |
| Use the sample code below to install the acquired DRM license. |
|
<html>
<head>
<Script Language="JavaScript">
function storeLic()
{
netobj.StoreLicense(PlayStream's License string goes here);
}
</Script>
</head>
<body onLoad="storeLic()">
<object id=netobj CLASSID="clsid:A9FC132B-096D-460B-B7D5-1DB0FAE0C062"
width=0 height=0>
</object>
</body>
< /html>
|
|
NOTES:
*** In this scenario Customer Profile – DOESN’T apply with delivery of licenses
through custom acquisition URL)
https://www.playstream.com/myaccount/content/drm/live.aspx
*** In this scenario, Subscription acts only as a rule template, content IDs do
not need to be associated with the subscription. |
|
| |
|
|
| Step 8 - Linking to your Encrypted Media |
| Information on Easy Link |
|
| Link to your encrypted media as you would to any other content in your
PlayStream account using PlayStream Easylink technology. For more information
about Easylink technology, please refer to our support section:
www.playstream.com/support/linking/easylink.aspx. |
|
| How to Link to Encrypted Content: |
|
-
Login into your PlayStream account at www.playstream.com using your PlayStream
Customer Login and Password.
-
Click on the "Manage Your Content" icon.
-
Click on the small "Manage Content" icon for the On-Demand Service name where
the content that you want to encrypt is stored.
-
Navigate to the file you want to link to.
-
Click on the file name link. You will be taken to the file info page.
-
Cut and paste the stream link from the text field into the source HTML for your
Web page in order to link to your encrypted media.
|
|