Locating the host factory RESTful APIs

The host factory RESTful APIs are available on the same management host that runs the HostFactory service. Run the egosh client view command to find the URL for the host factory RESTful APIs.

Procedure

From the command line, run the following command:
```
egosh client view REST_HOST_FACTORY_URL
```
The description in the results shows the URL in the format https://host_name:port/platform/rest/hostfactory. The default TLS port for host factory is 9443. For example:
```
https://myprimaryhost.example.com:9443/platform/rest/hostfactory
```
If you disabled security for host factory, the URL would be http://host_name:port/platform/rest/hostfactory. The default non-TLS port for host factory is 9080.
Tip: You can also access the APIs by specifying the API version in the path; the API methods are versioned, with /v1 indicating the current API version. For example:
```
https://myprimaryhost.example.com:9443/platform/rest/hostfactory/v1
```
Using the URL without the version always brings up the current API version.
When the browser prompts you about an untrusted connection, import the server certificate. If security was disabled for host factory, skip this step.
Note: If you are a cluster administrator, download the certificate from the server at:
- $EGO_TOP/wlp/usr/shared/resources/security/cacert.pem
- Installation_top\wlp\usr\shared\resources\security\cacert.pem
Ensure that you distribute this certificate to all your users who require access to the RESTful APIs.
The following steps apply only if you are using the default self-signed certificate with the certified browsers; the steps might be different with other browser versions. If you are using a properly chained certificate that is issued or signed by a trusted certificate authority in a production environment, follow the instructions provided by your certificate authority.
- If you are using Chrome on Windows, complete the following steps:
  1. From the browser, click Settings > Advanced > Privacy and Security > Manage Certificates > Import.
  2. Follow the Certificate Import Wizard, import the downloaded cacert.pem, click Place all certificates in the following store, click Browse, select Trusted Root Certification Authorities, and click OK.
  3. Complete the wizard and accept any additional prompts.
  4. Restart the browser, if required.
- If you are using Chrome on Mac OS, complete the following steps. You are required to enter your Keychain password for some of these steps:
  1. Double-click the cacert.pem file in the Finder.
  2. In the Add Certificates window, select System from the Keychain drop-down menu.
  3. Click Add.
  4. In the Keychain Access window, select the System tab and double-click the imported certificate.
  5. Under Trust, select Always Trust for all of the drop-down options.
  6. Exit the Keychain and restart the browser.
- If you are using Firefox on Windows, Linux®, or Mac OS, complete the following steps:
  1. Click Firefox > Settings > Privacy & Security > View Certificates.
  2. Click the Authorities tab and click Import.
  3. Select the certificate from the location where it is saved on your system.
  4. When prompted to trust a new CA, ensure that you select Trust this CA to identify websites and click OK.
  5. Restart the browser, if required.
- If you are using Microsoft Edge, complete the following steps:
  1. When the browser prompts you about a security certificate, click Continue to this website (not recommended).
  2. Click Certificate error in the address bar; then, View Certificates.
  3. In the Certificate dialog, click the Certification Path tab.
  4. Select IBM® Spectrum Computing Root CA (SHA256) and click View.
  5. If all looks well, click the General tab and click Install Certificate....
  6. In the Certificate Import Wizard, click Place all certificates in the following store, click Browse, select Trusted Root Certification Authorities, and click OK.
  7. Complete the wizard and accept any additional prompts.
  8. Restart the browser, if required.
Log in using the same credentials that you use to access the cluster management console and manage your cloud resource requests. See Obtain login tokens for host factory authentication.