...
Navigate to the URL of the machine in a web browser, this should bring up the OctoPrint Settings.
Obtain either the global api key or a user bound api key:
Click on Api in the left menu and note the
Apikey.Click on Access Control, create a new user or note the
Apikeyof an existing one that has at least STATUS permissions.
Creating a secret.txt file:
Simply copy the Apikey into a secret.txt file. Set the file name in the authentication_file_path field in your config.json file (see below).
Example content:
| Code Block |
|---|
A0A00B123E454H122BD513FE58B5E9BC |
...
Aggregator version 1.
...
Aggregator version 1.4+
Configuration | Data | Description | Required |
|---|---|---|---|
|
| The machine's interface type. | ✓ |
|
| The individual machine's interface url. | ✓ |
|
| The custom machine name to be displayed in the Agile MES. | ✗ |
|
| File containing API key. | ✓ |
|
| The MES instance(s) of your organization. | ✓ |
...
| Code Block | ||
|---|---|---|
| ||
{
"type": "OCTOPRINT",
"url": "http://192.168.1.41:5000",
"custom_name": "my_octoprint_machine",
"authentication_file_path": "secret.txt",
"mes_id": [
1
]
} |
OR
| Code Block | ||
|---|---|---|
| ||
{ "type": "OCTOPRINT", "url": "http://192.168.1.41:5000", "custom_name": "my_octoprint_machine", "authentication_file_path": "A0A00B123E454H122BD513FE58B5E9BC", "mes_id": [ 1 ] } |
Secret:
| Info |
|---|
Starting from version 1.4, you can also inline the contents of your secret file in the in the |
Simply copy the Apikey into a secret.txt file. Set the file name in the authentication_file_path field in your config.json file.
Example content:
| Code Block |
|---|
A0A00B123E454H122BD513FE58B5E9BC |
Aggregator version 1.2 - 1.3
...
| Code Block | ||
|---|---|---|
| ||
{
"type": "OCTOPRINT",
"url": "http://192.168.1.41:5000",
"custom_name": "my_octoprint_machine",
"authentication_file_path": "secret.txt",
"mes_id": [
1
]
} |
Secret:
Simply copy the Apikey into a secret.txt file. Set the file name in the authentication_file_path field in your config.json file.
Example content:
| Code Block |
|---|
A0A00B123E454H122BD513FE58B5E9BC |
Aggregator version 1.1
Configuration | Data | Description | Required |
|---|---|---|---|
|
| The machine's interface type. | ✓ |
|
| The individual machine's interface url. | ✓ |
|
| API key. | ✓ |
|
| The MES instance(s) of your organization. | ✓ |
|
| Umati server port used for internal data transfer. Set if the default port is conflicting with another port on your server. | X |
...
| Code Block | ||
|---|---|---|
| ||
{
"type": "OCTOPRINT",
"url": "http://192.168.1.41:5000",
"api_key": "A0A00B123E454H122BD513FE58B5E9BC",
"mes_id": [
1
]
} |
Secret:
Directly copy the API key in the config.json field api_key.