Claiming an appliance is the process of associating a newly created appliance with your account. This makes the appliance available for use and appear in the Alert Logic® console. Claiming an appliance can be done either automatically or manually.
The following article describes the various ways of claiming an appliance and how to claim an appliance via those methods.
Interactive Manual Appliance Claim
To manually claim an appliance interactively in the Alert Logic console, complete the following steps:
- Alert Logic Essentials, Professional, or Enterprise customers - Navigate to the menu icon () > Configure > Deployments > Data Center deployment > Configuration Overview > Installation Instructions. Under Networks, note the Unique Registration Key of the desired network.
Alert Logic Cloud Defender, Threat Manager, or Log Manager customers - Click the Settings icon () in the upper right-hand corner and choose Support Information. On the Details page, note your Unique Registration Key.
- Visit the URL that refers to the appliance to be claimed. This URL is http://<Appliance Public IP>. This URL will take you to a web page where you can enter the appliance's Unique Registration Key.
- Submit the Unique Registration Key on the appliance claim page accessed at the appliance URL you generated from its public IP address, and then click Claim Appliance.
The appliance will now be associated with your account.
Programmatic Manual Appliance Claim
If you have a need to programmatically execute the appliance claiming process, you are able to directly call via the Alert Logic API.
Run the following two HTTP requests to claim the appliance:
- curl -X POST -d "key=<Unique Registration Key>&name=<Name>" "http://<Appliance IP>/v1/set-key/index.php"
- curl http://<Appliance IP>/v1/restart-provision/index.php
Next, run the following HTTP request to confirm that the appliance has been successfully claimed:
- curl http://<Appliance IP>/v1/isclaimed/index.php
Where you see "<Unique Registration Key>" above in the HTTP requests, insert your Unique Registration Key, which can be found by following steps #1-3 under the Interactive Manual Appliance Claim section above.
Where you see "<Name>" above in the HTTP requests, insert the name that you would like the appliance to display as within the Alert Logic console. This is an optional value that you can omit if you'd like.
Appliance Auto-Claim with Amazon Web Services & Microsoft Azure
If you utilize appliances within Amazon Web Services (AWS) or Microsoft Azure, Alert Logic recommends that you take advantage of auto-claiming. You can auto-claim your AWS or Azure appliances by configuring a cross-account IAM or RBAC role in the Alert Logic console. Once you have configured an AWS or Azure appliance with a cross-account IAM or RBAC role, the appliance will automatically be claimed and no other actions will be required.
For detailed instructions on configuring AWS IAM cross-account roles, refer to our Configure Alert Logic Cloud Defender AWS cross-account role documentation.
For detailed instructions on configuring Microsoft Azure RBAC roles, refer to our Configure RBAC roles in Azure documentation.