Endpoint Settings

These settings are used to configure CommandBox's endpoints.

Whenever possible, use the forgebox endpoint namespace unless you are setting things manually when those settings not supported by those commands.

Default ForgeBox Endpoint

endpoints.forgebox.APIToken

string

The API Token provided to you when you signed up for ForgeBox.io. This will be set for you automatically when you use the forgebox register or forgebox login commands. This token will be sent to ForgeBox to authenticate you. Please do not share this secret token with others as it will give them permission to edit your packages!

config set endpoints.forgebox.APIToken=my-very-long-secret-key
config show endpoints.forgebox.APIToken

endpoints.forgebox.APIURL

string

This is the URL of the ForgeBox REST API. Remove this setting to use the default. If you wish change the default Forgebox entry to point to your ForgeBox Enterprise you can do that here. Note, this will funnel ALL ForgeBox calls to the enterprise server where your APIToken may be different. We recommend custom endpoints as an alternative to overriding the default.

forgebox endpoint register forgebox https://mycompany.forgebox.io/api/v1 --force 
# or
config set endpoints.forgebox.APIURL=https://mycompany.forgebox.io/api/v1
config show endpoints.forgebox.APIURL

Custom Endpoint Settings

You can create your own endpoints usually when you have an ForgeBox Enterprise appliance, and change the default from ForgeBox to your own if desired. All commands will assume the endpoint is the default unless override with the forgebox publish endpointName=MYENDPOINT or forgebox whoami endpointName=MYENDPOINT for example.

You can register a new endpoint with forgebox endpoint register myEndpoint "https://forge.intranet.local/api/v1"

You can see all of your current endpoints with forgebox endpoint list which will list out all of your endpoints, including indicating the default endpoint.

Endpoint: forgebox (Default)
  API URL: https://www.forgebox.io/api/v1/

Endpoint: mycompany
  API URL: https://mycompany.forgebox.io/api/v1

To view this as JSON we can run config show endpoints and you'll see what this looks like in the config structure.

{
    "forgebox":{
        "APIToken":"YOUR-API-TOKEN-HERE"
    },
    "forgebox-mycompany":{
        "APIURL":"https://forgebox.stg.ortushq.com/",
        "APIToken":"YOUR-COMPANY-FORGEBOX-API-TOKEN-HERE"
    }
}

When setting APIToken and APIURL for Custom Endpoints, it is a little different, you must use ForgeBox-YOURENDPOINTNAME in the commands to match the data structure.

endpoints.forgebox-MYENDPOINTNAME.APIToken

string

The API Token provided to you when you signed up for your Custom ForgeBox Site/Appliance. This will be set for you automatically when you use the forgebox register or forgebox login commands if this endpoint is the default, or if you use forgebox login endpointName=mycompany if mycompany is not the default. This token will be sent to the ForgeBox endpoint to authenticate you. Please do not share this secret token with others as it will give them permission to edit your packages!

config set endpoints.forgebox-mycompany.APIToken=my-very-long-secret-key
config show endpoints.forgebox-mycompany.APIToken

endpoints.forgebox-MYENDPOINTNAME.APIURL

string

This is the URL of the ForgeBox REST API for your custom endpoint. Note, this will funnel ALL ForgeBox calls to this URL if this endpoint is the default, or if you use forgebox publish endpointName=mycompany if mycompany is not the default.

forgebox endpoint register mycompany https://mycompany.forgebox.io/api/v1 --force 
# or
config set endpoints.forgebox-mycompany.APIURL=https://mycompany.forgebox.io/api/v1
config show endpoints.forgebox-mycompany.APIURL

Last updated