Skyhook Self Service Portal

Skyhook Self Service Portal

The skyhook self service portal can be used to create new skyhook tenants and renew expiring dbAccessTokens for extensions that use our skyhook service. Customers can access the portal on this link https://clearpass.arubanetworks.com/webhooks/skyhook and can login using their HPE passport credentials.

This portal allows administrators to create skyhook tenants for various integrations that support webhook notifications. Upon registering for a skyhook tenant you are provided with a ‘Tenant ID’ that can be used in the “skyhookTenant” field and a DB token that goes in the “dbAccessToken” field of the extension configuration. Once a tenant is registered, the dbAccessToken for the tenant is valid for a year. For an uninterrupted service, customers are required to renew their DB token by logging in to the portal and following the renewal steps. All registered skyhook tenants are mapped under the HPE Passport used to login to the self service portal.

The portal gives a list of all registered tenants including the App name (Integration e.g Jamf, Envoy etc), the expiration date and time until expiration to let administrators choose when they want to renew the DB token as per their convenience.

Using the Skyhook Self Service Portal

Creating a new Skyhook Tenant

• Go to https://clearpass.arubanetworks.com/webhooks/skyhook and click on ‘Login with HPE SSO’ option.
  
  

  

  
  
  

• Enter your HPE passport credentials to login.

• The landing page displays the skyhook tenants registered with the HPE Passport credentials under the ‘Your Tenants’ page.

• To create a new tenant Click on ‘Register Tenant’.
  
  

  

  
  
  

INFO

Note that the portal reaches out to the domain “skyhook.clearpassbeta.com” for creating new tenant. The domain and the URL should be allow listed through any endpoint security or SSE solutions installed on the device you are accessing the portal from and also through firewalls that the traffic is traversing through.

https://skyhook.clearpassbeta.com/api/register/<name-of-extension>

If the portal is unable to reach the tenant registration URL, you might see an error as shown below.

• Choose the integration name as needed from the ‘App’ dropdown, Enter a suitable label and click on ‘Register’.
  
  

  

  
  
  

• The tenant and the DB token is displayed. Ensure to copy / download the details as the token is displayed only once. Once done, click ‘OK’ to return to the ‘Your Tenants’ page.
  
  

  

  
  
  

• Once you have the SkyhookTenant and the dbAccessToken, You can continue with the further ClearPass Extension configuration as per the steps decribed in the integration guide for the extension you are installing. Existing integrations which were using legacy manually provisioned tenant ID, would have to ensure that the tenant ID is updated on the third-party application with the new one from self-service portal.

Renewing the DB token

• Select the Tenant that needs DB token renewal. You can use the Search box to search for Tenants based on their Tenant name or Label on the upper left corner of the page.
  
  

  

  
  
  

• Click on the ‘Renew’ option under the ‘Actions’ column to proceed with the renewal of the DB token.
  
  

  

  
  
  

• The tenant and the DB token is displayed. Ensure to copy / download the details as the token is displayed only once. Once done click ‘OK’ to return to the ‘Your Tenants’ page.