Table of contents
TOC
Collapse the table of content
Expand the table of content

Set up a Trusted Application Endpoint

davnewman|Last Updated: 2/17/2017

Tenant Admin Provisioning includes setting up the trusted endpoints and tenant admin consent. Please refer Tenant Admin Consent for a tenant to consent to the application.

You can easily register Trusted Application Endpoints by using the PowerShell cmdlets. General information about PowerShell cmdlets usage can be found in Using Windows PowerShell to manage Skype for Business Online. You will need to complete the following steps to run the admin PowerShell:

  1. Download and install the Skype for Business Online Connector module
  2. Connecting to Skype for Business Online by using Windows PowerShell

Managing Trusted Application Endpoint With PowerShell

Note: For assigning a PSTN phone number to a Trusted Endpoint, you will need to follow the steps below acquire a service number that will be assigned to Trusted Application Endpoint. Assigning a phone number is optional. If assigning a phone number to your endpoint, acquiring a service number should be completed before running the Powershell cmdlets. See details below.

  1. Follow the documentation to connect to the Skype for Business PowerShell cmdlets The following cmdlets can be used to setup trusted application endpoints:
  • New-CsOnlineApplicationEndpoint - It creates a new application endpoint.
ParametersRequiredTypeDescription
NameRequiredStringFriendly name for Application endpoint
ApplicationIdRequiredGuidUnique application Id that this endpoint will use.
UriRequiredStringThe SipUri for the Endpoint.
PhoneNumberOptionalStringPhone number for the endpoint.
  • Get-CsOnlineApplicationEndpoint - It is used to fetch the application endpoints for the tenants.
ParametersRequiredTypeDescription
UriRequiredStringThe SipUri for the Endpoint.
  • Set-CsOnlineApplicationEndpoint - It is used to update the application endpoint.
ParametersRequiredTypeDescription
UriRequiredStringThe SipUri for the Endpoint.
PhoneNumberOptionalStringPhone number for the endpoint.
  • Remove-CsOnlineApplicationEndpoint - It is used to remove the application endpoint.
ParametersRequiredTypeDescription
UriRequiredStringThe SipUri for the Endpoint.

Note: For PSTN, Assign the service numbers to the trusted application endpoint using New-CsOnlineApplicationEndpoint PhoneNumber parameter. PhoneNumber is not required.

Detailed Explanation of Parameters

  • ApplicationId: The Azure ApplicationID/ClientID from the Azure portal registration steps.

  • Name: A friendly name of your application within Skype for Business Online.

  • Tenant: The Tenant ID of the tenant where you are registering a trusted application endpoint.

  • Uri: Sip Uri that identifies the tenant specific endpoint for the application. This must be a unique URI that does not conflict with an existing user in the tenant. Requests sent to this endpoint will trigger the Trusted Application API sending an event to the application, indicating that someone has sent a request. Eg. helpdesk@contoso.com

Example

The following PowerShell cmdlet creates a new application endpoint.

New-CsOnlineApplicationEndpoint -Uri "sip:sample@domain.com" -ApplicationId "44ff763b-5d1f-40ab-95bf-f31kc8757998" -Name "SampleApp" -PhoneNumber "19841110909"

Assigning a Phone Number to a Trusted Endpoint

  1. For PSTN, You are required to have an E5 license to enable PSTN calling with the Trusted Application API. To enable PSTN calling, the Skype for Business Domestic and International Calling feature must be active. Please refer to products.microsoft.com for more details.

  2. For PSTN, Acquire the service numbers to assign to the trusted application endpoint. Please refer to support.office.com for more details.

    Assign service telephone number

© 2017 Microsoft