ESDService Web Service

Description

Electronic Software Delivery Service (ESD Service) provides interfaces for accessing information related to the Software Delivery Module.

Introduction

Simple Workflow Using ESD Service APIs

1. Get the list of accounts that the logged-in user belongs to, that have entitlements, and let the user select an account.

   • Use getEntitledOrganizations API

2. Display all manufacturers that are on the entitlements for the selected account, and Product Lines, and allow the user to select.

   • Use getManufacturerProductLine API

3. Display all Download Packages that belong to the selected product line, and allow the user to select a Download Package.

   • Use getDownloadPackages API

4. Get the compliance information and EULA for the selected Download Package.

   • Use getEULA, acceptEULA APIs

   • Use getComplianceAgreement, acceptComplianceAgreement APIs

5. If the user is compliant, and has accepted the EULA, then display the files required for that Download Package.

   • Use getDownloadableFiles API

   • If the request for files specifies that EUAL acceptance, and compliance, are required then getDownloadableFiles will return an error and the user should be prompted with an appropriate message.

How to Get an Authentication Token

To get an authentication token,

• Use getSecureToken web method to generate the token from FlexnetAuthentication Web Service.

• Request the token using any user credentials in the UserId and UserPassword fields.

  Note: Ensure to use the same user credentials in the SOAP header of ESD service.

• The sample SOAP request for generating token:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:v1.webservices.platform.flexnet.com">
    <soapenv:Header>
                 <UserId>FNO ALM User ID</UserId>
                  <UserPassword>FNO ALM Password in Base64 format</UserPassword>
             </soapenv:Header>
    <soapenv:Body>
       <urn:secureTokenRequest>
          <urn:userId>FNO ALM User ID</urn:userId>
          <!{}Optional:{}>
          <urn:tokenTimeoutSeconds>200</urn:tokenTimeoutSeconds>
       </urn:secureTokenRequest>
    </soapenv:Body>
 </soapenv:Envelope>

Note:

The tokenTimeoutSeconds can be any number of seconds, but it defaults to 300 seconds (5 minutes).

• Getting a new token does not invalidate a previously requested token (which remains valid until expiry).

How to Include the Token Generated in ESD Service

To include the token generated in ESD service,

• Use a valid token (non-expired) in the SOAP header for authenticating the service in the SOAP request.

• The sample SOAP header:

 <soapenv:Header>
   <nsAuth:authnHeader>
     <nsAuth:id>FNO ALM User ID</nsAuth:id>
     <nsAuth:token>Token generated using FlexAuthService</nsAuth:token>
      <nsAuth:partnerCode>Tenant Id</nsAuth:partnerCode>
       </nsAuth:authnHeader>
 </soapenv:Header>

• A sample SOAP request for one of the web methods in ESD service with authentication token in the soap header:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
            xmlns:esd="http://esdservice.esd.flexerasoftware.com"
            xmlns:nsAuth="http:/common.handler.flexerasoftware.com/authn">
            <soapenv:Header>
                <nsAuth:authnHeader>
                 <nsAuth:id>user@flexerasoftware.com</nsAuth:id>
                 <nsAuth:token>sTc2PAj5VOrer5WlGP39N9GBpCqJulmIrVrNof-Ciq1FdDYp_TeZlpbFwfFJC3BcZ9MO6nkDXvUvWGmi5IGr2sGp8-vS6L1FqMxeYhnGF5Skv_OmVoNMqlP6uE9rQY7FTHonX80hFbQ</nsAuth:token>
                <nsAuth:partnerCode>se02</nsAuth:partnerCode>
                </nsAuth:authnHeader>
            </soapenv:Header>   
   <soapenv:Body>
      <esd:getEULARequest>
         <esd:DownloadPackageReference>
            <!{}Optional:{}>
            <esd:Id>23232</esd:Id>
            <esd:SystemId>2323</esd:SystemId>
         </esd:DownloadPackageReference>
         <esd:OrganizationId>232323</esd:OrganizationId>
      </esd:getEULARequest>
   </soapenv:Body>
</soapenv:Envelope>