Method 1: Perform Auto Discovery of the Controller Using the SmartLicense Server

AP Registrar is a RUCKUS-hosted cloud based software service (@ apregistrar.ruckuswireless.com) that provides customers a simple, easy to use and completely secure “controller discovery” mechanism for securely adding and registering APs to be managed by an appropriate controller.

The following are some of benefits of using the AP Registrar:

  • APs are registered to the controllers using their serial numbers
  • APs and controller mappings are fully controllable
  • Customers can provision the AP Registrar via secure JSON APIs that are protected by a unique customer key

Configuring the AP Registrar

The AP Registrar can be programmed using RESTful JSON APIs. In order to provide security to access the AP Registrar, it is important for you to obtain a certificate from RUCKUS Networks.

Please follow these IMPORTANT steps to obtain a certificate and the API Guide from RUCKUS Networks to access the AP Registrar.

  1. Ensure that you have purchased on-going support for all your RUCKUS equipment and products.
  2. Ensure that you have a signed and fully executed NDA with RUCKUS Networks. If you have not signed NDA, reach out to RUCKUS Networks APR support team.
  3. Ensure that you have signed the AP Registrar T&C (Terms and Conditions) document. Reach out to RUCKUS Networks APR support team for the T&C document
  4. Provide the domain name (FQDN - non wildcard) from where you will access the AP Registrar. This is needed to provide correct access to the API. It is recommended to set up a specific FQDN (for example, apr.customerdomain.com) and set the ARecord to the IP address from which they will need to access the AP Registrar.
  5. Provide your GPG signed public key. This is needed to securely send a package back to you that contains their API key and digital certificate.
  6. Provide all these details to dl-apr-support@ruckuswireless.com.

Once you complete the above steps, you will receive a package that contains the API documentation, sample code, as well as a client-side certificate that you can use to provision the AP Registrar using the APIs. Important Notes

Important notes

  • To use AP Registrar API, you must pre-register an FQDN with RUCKUS Networks and the company will provide an SSL certificate, signed by a recognized certificate authority and bearing the FQDN in the certificate's subject common name field.
  • The certificate must be presented to the API server when making API requests. The API requester must be in possession of the certificate's private key.
  • The FQDN (without wildcard) in the certificate's subject common name field must match that mentioned in the API user's user record.
  • The DNS IP address of the FQDN must match the Internet routable IP address of the computer from which the API request is generated.
  • If any of the above three conditions are not met, the API request will fail with a 401 error.