Configuring endpoints to support One-Touch Join
This topic describes how to configure each of the supported endpoint types so they can be used with Pexip Infinity One-Touch Join.
Prerequisites
We recommend that you have already completed the steps in Configuring Pexip Infinity for One-Touch Join. In particular, you will need some of the information that you previously entered when Adding One-Touch Join endpoints to Pexip Infinity, in order to complete the configuration on each endpoint.
Configuring Cisco OBTP endpoints for OTJ
In order for Cisco OBTP endpoints to obtain One-Touch Join meeting information, the Conferencing Node associated with the endpoint uses the endpoint's API to push the information out to the endpoint.
The endpoint must have an account set up with a role of Admin that can be used by One-Touch Join to access the endpoint's API.
Hiding or changing the meeting subject
The next major release of Pexip Infinity, version 25, will include options to hide or change the meeting subjects that will appear on OTJ endpoints, according to rules that can be applied across your One-Touch Join deployment. In the meantime, you can hide meeting subjects from appearing on the screen of individual Cisco endpoints (running CE 9.12.3 or later) by configuring the endpoint as follows:
Configuring Poly OTD endpoints for OTJ
In order for Poly OTD endpoints to obtain One-Touch Join meeting information, each One-Touch Join Conferencing Node emulates a Microsoft Exchange server. The Poly endpoint then connects to the Conferencing Node and registers to the calendaring service on the node in order to pull meeting information, as shown in the diagram below.
Note that this emulation of an Exchange calendaring service on the Conferencing Node is purely to provide the Poly endpoint with its meeting information. It is completely separate to the process by which the Conferencing Node initially obtains the meeting information from the calendar/email service being used for One-Touch Join — which can be either Exchange or G Suite.
It is important that you do not set up your Poly endpoints until after you have completed the steps to add the endpoint details to Pexip Infinity.
DNS records
If you have a One-Touch Join deployment that includes Poly endpoints in a location with more than one Conferencing Node, you should spread the Poly endpoint registrations across all nodes in the location to maximize performance and provide redundancy. To achieve this, we recommend that all Poly endpoints in a location register to a single FQDN which uses round-robin DNS to resolve to each Conferencing Node in turn. This will require you to set up appropriate DNS records for all Conferencing Nodes in the location, and ensure that your DNS server is configured to round-robin between these records.
For more information and examples, see Enabling Poly endpoints to register to One-Touch Join.
Poly authentication
In normal Pexip Infinity usage Poly endpoints authenticate to One-Touch Join using digest authentication, with the exception of HDX endpoints which require NTLMv2.
When Pexip Infinity has been deployed in a secure mode of operation (and therefore FIPS compliance has been enabled), NTLMv2 and digest authentication are disabled and basic authentication is used. As a result, when in this mode:
- HDX endpoints are not supported
- Trio endpoints must be configured to allow basic authentication.
To configure a Poly RealPresence Group Series for One-Touch Join, use the following settings:
Field |
Poly configuration |
Matching Infinity configuration |
Additional info |
---|---|---|---|
The email address of the room resource configured in Exchange or G Suite that is associated with this endpoint. |
This must be the same as the Room resource email configured on Pexip Infinity for this endpoint. |
||
Domain |
Leave blank. |
This is the Exchange domain, and is not required for One-Touch Join. |
|
The username the endpoint will use when connecting and authenticating to the calendaring service on the Conferencing Node, to obtain meeting information. |
This must be the same as the Poly Calendaring Username configured on Pexip Infinity for this endpoint. |
This field is case-sensitive. |
|
The password the endpoint will use when connecting and authenticating to the calendaring service on the Conferencing Node, to obtain meeting information. |
This must be the same as the Poly Calendaring password configured on Pexip Infinity for this endpoint. |
This field is case-sensitive. |
|
Auto Discover Using |
Do not select this button. |
Auto Discovery is not supported. Instead, you should manually configure the Microsoft Exchange Server settings. |
|
Microsoft Exchange Server |
In both cases, the location is the Pexip Infinity location associated with the Endpoint Group to which this endpoint belongs. |
|
|
Secure Connection Protocol |
Select Automatic. |
||
Meeting Reminder Time in Minutes |
Optional |
Can still be used in conjunction with One-Touch Join. |
|
Play Reminder Tone When Not in a Call |
Optional |
Can still be used in conjunction with One-Touch Join. |
|
Show Information for Meetings Set to Private |
Optional |
Enable private meetings must be enabled on the One-Touch Join Profile associated with this endpoint in order for this setting to apply. If Enable private meetings has been disabled on the One-Touch Join Profile, this setting will have no effect. |
To confirm that the Poly RealPresence Group Series endpoint has registered successfully with the calendaring service:
- On the endpoint, go to .
- Confirm that the Registration Status is showing as Registered.
When configuring Poly Trio series endpoints for One-Touch Join, you should use a Generic base profile unless your deployment specifically requires you to use a Skype for Business base profile. Configuration instructions for each are given below.
Configuring Poly Trio using a generic base profile
- Open the endpoint's web configuration utility at https://<ipaddress>, select Admin, and log in using the admin password.
- From Generic and then select . select
- Edit the config file as follows (this can be done via
- add feature.contactPhotoIntegration.enabled="0"
- if the Trio is running software version 5.9.1.11135 or later and Pexip Infinity has been deployed in a secure mode of operation (and therefore FIPS compliance has been enabled), you must allow the Trio to use basic authentication:
add feature.exchange.allowBasicAuth="1"
):
-
From
, configure the Poly trio as follows:Field Poly configuration
Matching Infinity configuration
Additional info
Exchange Applications Exchange Calendar Select Enable. Auto Discover Using
Select Disable.
Auto Discover is not supported. Instead, you should manually configure the Exchange Server URL settings.
Exchange Server URL Enter https://<address>/EWS/Exchange.asmx
For <address>:
- If you have a single Conferencing Node in this location, enter the IP Address or FQDN of the node.
- If you have multiple Conferencing Nodes in this location, you should use DNS round robin; therefore this will be the FQDN of the DNS record for this location.
In both cases, the location is the Pexip Infinity location associated with the Endpoint Group to which this endpoint belongs.
Exchange Sign-In * Exchange Email
Leave blank.
Domain
Leave blank.
This is the Exchange domain, and is not required for One-Touch Join.
The username the endpoint will use when connecting and authenticating to the calendaring service on the Conferencing Node, to obtain meeting information.
This must be the same as the Poly Calendaring Username configured on Pexip Infinity for this endpoint.
This field is case-sensitive.
The password the endpoint will use when connecting and authenticating to the calendaring service on the Conferencing Node, to obtain meeting information.
This must be the same as the Poly Calendaring password configured on Pexip Infinity for this endpoint. This field is case-sensitive.
* Available for endpoints running version 5.9.2.7727 or later. For earlier versions, you must have physical access to the endpoint's touch screen; use this to log in using the User and Password credentials as described above.
To confirm that the Poly Trio endpoint has registered successfully with the calendaring service:
- On the endpoint, go to .
- Confirm that Exchange Calendar is showing as Synchronized.
Configuring Poly Trio using Skype for Business base profile
You should only use the Skype for Business base profile if specifically required in your deployment (for example, if you wish to place PSTN calls via Skype for Business server); otherwise use the generic base profile.
When the Trio is configured as described below, it will still register with the calendaring service on the Conferencing Node to obtain meeting information, but it will also register with Skype for Business and use that to place outbound calls.
- Open the endpoint's web configuration utility at https://<ipaddress>, select Admin, and log in using the admin password.
- From Skype for Business and then select . select
- Edit the config file as follows (this can be done via
- add feature.exchangeVoiceMail.enabled="0"
- add exchange.showSeparateAuth="1"
- add feature.exchangeContacts.enabled="0"
):
-
From
, configure the Poly trio as follows:Field Poly configuration
Matching Infinity configuration
Additional info
Skype for Business Use User Credentials Select Enable. Authentication Type Select User Credentials. Sign-in Address The endpoint's Skype for Business address. Domain The endpoint's Skype for Business domain. User The name the endpoint will use to authenticate with Skype for Business. Password The password the endpoint will use to authenticate with Skype for Business. Microsoft Exchange Server Configuration The email address of the room resource that is associated with this endpoint.
This must be the same as the Exchange target mailbox configured on the endpoint, and Room resource email configured on Pexip Infinity for this endpoint. Exchange Domain
Leave blank.
Exchange User
The username the endpoint will use when connecting and authenticating to the calendaring service on the Conferencing Node, to obtain meeting information.
This must be the same as the Poly Calendaring Username configured on Pexip Infinity for this endpoint.
This field is case-sensitive.
Exchange Password
The password the endpoint will use when connecting and authenticating to the calendaring service on the Conferencing Node, to obtain meeting information.
This must be the same as the Poly Calendaring password configured on Pexip Infinity for this endpoint. This field is case-sensitive.
Exchange Target Mailbox The email address of the room resource that is associated with this endpoint.
This must be the same as the Exchange Email configured on the endpoint, and Room resource email configured on Pexip Infinity for this endpoint. -
From
, configure the Poly trio as follows:Field Poly configuration
Matching Infinity configuration
Additional info
Exchange Applications Exchange Calendar Select Enable. Auto Discover
Select Disable.
Auto Discover is not supported. Instead, you should manually configure the Exchange Server URL settings.
Exchange Server URL Enter https://<address>/EWS/Exchange.asmx
For <address>:
- If you have a single Conferencing Node in this location, enter the IP Address or FQDN of the node.
- If you have multiple Conferencing Nodes in this location, you should use DNS round robin; therefore this will be the FQDN of the DNS record for this location.
In both cases, the location is the Pexip Infinity location associated with the Endpoint Group to which this endpoint belongs.
To confirm that the Poly Trio endpoint has registered successfully with the calendaring service:
- On the endpoint, go to .
- Confirm that Exchange Calendar is showing as Synchronized.
To configure the Poly HDX for One-Touch Join, go to the endpoint's IP address.
From
, enter the following:Field |
Poly configuration |
Matching Infinity configuration |
Additional info |
---|---|---|---|
Enable Calendaring Service | Select this option. | ||
Microsoft Exchange Server Address |
In both cases, the location is the Pexip Infinity location associated with the Endpoint Group to which this endpoint belongs. |
|
|
Domain |
Leave blank. |
This is the Exchange domain, and is not required for One-Touch Join. |
|
User Name |
The username the endpoint will use when connecting and authenticating to the calendaring service on the Conferencing Node, to obtain meeting information. |
This must be the same as the Poly Calendaring Username configured on Pexip Infinity for this endpoint. |
This field is case-sensitive. |
Select this option. The following two fields will appear: |
|
||
New Password Confirm Password |
The password the endpoint will use when connecting and authenticating to the calendaring service on the Conferencing Node, to obtain meeting information. | This must be the same as the Poly Calendaring password configured on Pexip Infinity for this endpoint. | This field is case-sensitive. |
Mailbox |
For Exchange integrations: the email address of the room resource configured in Exchange that is associated with this endpoint. For G Suite integrations: the User Name entered above. |
For Exchange integrations, this must be the same as the Room resource email configured on Pexip Infinity for this endpoint. | |
Reminder Time in Minutes |
Optional |
Can still be used in conjunction with One-Touch Join. |
|
Play Reminder Tone |
Optional |
Can still be used in conjunction with One-Touch Join. |
|
Show Private Meeting Information |
Optional |
Enable private meetings must be enabled on the One-Touch Join Profile associated with this endpoint in order for this setting to apply. If Enable private meetings has been disabled on the One-Touch Join Profile, this setting will have no effect. |
To confirm that the Poly HDX endpoint has registered successfully with the calendaring service:
- On the endpoint, go to .
- Confirm that there is a green tick next to Enable Calendaring Service.
To configure the Poly Studio or Poly G7500 for One-Touch Join, go to the endpoint's IP address and sign in to the endpoint if required.
From
, enter the following:Field |
Poly configuration |
Matching Infinity configuration |
Additional info |
---|---|---|---|
Enable Calendaring Service | Select this option. | ||
The email address of the room resource configured in Exchange or G Suite that is associated with this endpoint. |
This must be the same as the Room resource email configured on Pexip Infinity for this endpoint. | ||
Domain |
Leave blank. |
This is the Exchange domain, and is not required for One-Touch Join. |
|
User Name |
The username the endpoint will use when connecting and authenticating to the calendaring service on the Conferencing Node, to obtain meeting information. |
This must be the same as the Poly Calendaring Username configured on Pexip Infinity for this endpoint. |
This field is case-sensitive. |
The password the endpoint will use when connecting and authenticating to the calendaring service on the Conferencing Node, to obtain meeting information. |
This must be the same as the Poly Calendaring password configured on Pexip Infinity for this endpoint. |
This field is case-sensitive. |
|
Microsoft Exchange Server |
In both cases, the location is the Pexip Infinity location associated with the Endpoint Group to which this endpoint belongs. |
|
|
Meeting Reminder Time in Minutes |
Optional |
Can still be used in conjunction with One-Touch Join. |
|
Play Reminder Tone When Not in a Call |
Optional |
Can still be used in conjunction with One-Touch Join. |
|
Show Information for Meetings set to Private |
Optional |
Enable private meetings must be enabled on the One-Touch Join Profile associated with this endpoint in order for this setting to apply. If Enable private meetings has been disabled on the One-Touch Join Profile, this setting will have no effect. |
To confirm that the Poly Studio / Poly G7500 endpoint has registered successfully with the calendaring service:
- On the endpoint, go to .
- Confirm that the Registration Status is showing as Registered.
To configure the Poly Debut for One-Touch Join, from , enter the following:
Field |
Poly configuration |
Matching Infinity configuration |
Additional info |
---|---|---|---|
Enable Calendar | Select Enable. | ||
Microsoft Exchange Server |
In both cases, the location is the Pexip Infinity location associated with the Endpoint Group to which this endpoint belongs. |
|
|
Domain |
Leave blank. |
This is the Exchange domain, and is not required for One-Touch Join. |
|
User Name |
The username the endpoint will use when connecting and authenticating to the calendaring service on the Conferencing Node, to obtain meeting information. |
This must be the same as the Poly Calendaring Username configured on Pexip Infinity for this endpoint. | This field is case-sensitive. |
The password the endpoint will use when connecting and authenticating to the calendaring service on the Conferencing Node, to obtain meeting information. |
This must be the same as the Poly Calendaring password configured on Pexip Infinity for this endpoint. |
This field is case-sensitive. |
To confirm that the Poly Debut endpoint has registered successfully with the calendaring service:
- On the endpoint, go to the Device Status page.
- In the Calendar row of the table, check that the Status is showing as Registered.