Enrollment codes (On-Premises Platform 8.0 or later, and Reveal Cloud only)

With the new enrollment UI and code mechanism introduced in 8.0 and recent Reveal cloud instances, it is now possible to create an enrollment code or bundle file with any chosen expiration time. It is also possible to extend the expiration date of existing codes and bundles. Note that this is only possible for codes or bundles generated after this feature was introduced.

Please visit

https://<your-reveal-url>/#deployment/enrollments

Earlier On-Premises instances (7.0 or earlier)

To create a bundle file with an expiry longer than one month, you must use the Reveal API. First create an access token for your API application, and then enrollment bundles can be created with an HTTP POST to https://<your-reveal-url>/api/v1/admin/agent/enroll.

The following parameters should be supplied;

NameDescription
max_usesThe maximum number of agents that can be enrolled with the bundle
expiryThe expiry date of the enrollment bundle, e.g 2019-07-01T12:00:00.000Z
location(optional) The latitude and longitude coordinates, separated by a space 

The following example Python script will create a multi-use enrollment bundle with a one year expiry time;

#!/usr/bin/env python

import requests
import time

access_token = "INSERT_AUTH_TOKEN_HERE"
server_address = "https://AVA_REVEAL_ADDRESS"

headers = {'authorization':'bearer '+access_token}


#make this expire in one year
expiry = time.time() + (365*24*60*60)
expiry_string = time.strftime('%Y-%m-%dT%H:%M:%S.000Z',time.gmtime(expiry))

agent_info = {'name':'long-expiry', 'expiry':expiry_string,'max_uses':1000}
# For Reveal servers that dont have signed certificates, add "verify=False" in the post parameters
r = requests.post(server_address+"/api/v1/admin/agents/enroll", headers=headers, json=agent_info, stream=True)
bundlefile = open('longexpiry.bundle', "wb")
for chunk in r.iter_content(chunk_size=512):
  if chunk:
    bundlefile.write(chunk)
bundlefile.close()