Toggle Sidebar



For ClearOS 7, a simple shared API key has been implemented to provide authentication as well as full authorization. This API key has been automatically generated and stored in /etc/api.conf:

api_key = abc123key

You can authenticate you API requests by using this key in the request header, e.g.

curl -k -s -H "x-api-key: abc123key"

You should see output similar to below:

    "status_code": "0",
    "status_message": "Success",
    "data": {
        "enp0s3": {
            "address": "",
            "netmask": "",
            "broadcast": "",
            "hwaddress": "08:00:27:30:27:36",
            "mtu": 1500,
            "speed": 1000,
            "type": "Ethernet",
            "type_text": "Ethernet",
            "vendor": "Intel Corporation",
            "device": "82540EM Gigabit Ethernet Controller",
            "sub_device": "PRO/1000 MT Desktop Adapter",
            "role": "EXTIF",
            "role_text": "External"

SSH Digital Signatures

In the future, authentication and authorization will be provided through SSH digital signatures in a similar way to AWS API Signatures.