LinMin Bare Metal Provisioning's API access is restricted to known IP addresses and requires authorization tokens called APIDs (short for API IDs.)

 

Authorization APIDs are created and managed via a script available only to the root user on the LinMin Server. After providing a user name, password and the IP address of the server running your application that interacts with the LinMin Server API, you will be issued an Authorization APID.

 

Collectively, the Authorization APID, your user name and password can used at any time to request access to the LinMin Server API for a period of 5 minutes. This 5-minute token is called an Action APID and must accompany any request your application makes of the LinMin Server API to perform any supported Provisioning or Imaging action (read, add, delete, provision, backup, etc.)

 

This Topic covers how to create, maintain and delete Authorization APIDs. The next Topic addresses how to obtain 5-minute Action APIDs.

 

 

Logged in as root:

cd /home/tftpboot/bin

sh lbmp-API_APID_management.sh

 

Example: add a Authorization APID:

Select APID Action:

----> type response and press enter, "q" will quit the process

add, change, delete, quit; a/c/d/q: a

 

----> type response and press enter, "q" will quit the process

Calling IP address: 192.168.0.106

 

Choose a User name for this server

----> type response and press enter, "q" will quit the process

Calling user name: cloud_manager

 

Choose a User password for this server

Avoid special characters, more than 8 letters and numbers work best

----> type response and press enter, "q" will quit the process

Calling user password: cQ4w9tSb

................................................................................

................................................................................

IP APIDs list:

key:  1 IP: 192.168.0.106   APID: 203073805ccd0c6f700d3246955bcb34

LAST AUTH: not_activated       USER: cloud_manager:cQ4w9tSb

 

 

Example: change the password of an existing "Authorization APID":

Select APID Action:

----> type response and press enter, "q" will quit the process

add, change, delete, quit; a/c/d/q: c

----> type response and press enter, "q" will quit the process

Change which APID entry key number: 1

 

Choose a User name for this server

----> type response and press enter, "q" will quit the process

Calling user name [cloud_manager]:

 

Choose a User password for this server

Avoid special characters, more than 8 letters and numbers work best

----> type response and press enter, "q" will quit the process

Calling user password [cQ4w9tSb]: cl0ud491

................................................................................

................................................................................

IP APIDs list:

key:  1 IP: 192.168.0.106   APID: 048868af3b45ecde0ba08655abdc4d48

LAST AUTH: not_activated       USER: cloud_manager:cl0ud491

 

Select APID Action:

----> type response and press enter, "q" will quit the process

add, change, delete, quit; a/c/d/q: q

 

 

You will now use your Authorization APID, user name and password to request an Action APID granting your application access to the LinMin Server API for up to 5 minutes.