Cloudflare

Registering an account for Cloudflare in MechCloud OIDC Proxy

Once you have deployed MechCloud OIDC proxy in your Cloudflare account, you will need to add an account for Cloudflare before using the REST API agent for managing your Cloudflare account resources. Here is the curl command to register a Cloudflare account in MechCloud OIDC proxy -

curl --location 'https://<oidc_proxy_custom_domain>/api/accounts' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <mechcloud_jwt_token>' \
--data '{
    "id": "cloudflare_account1",
    "auth": {
        "type": "bearer",
        "token": "<cloudflare_api_token>"
    }
}'

Above command requires a MechCloud jwt token which can be generated by logging into MechCloud console and then opening https://portal.mechcloud.io/oauth2/auth1 link in the same or a different tab. Instructions for getting Cloudflare API token are there in the MechCloud OIDC proxy readme file. Make sure that the generated Cloudflare API token is having permissions for the action you are going to perform using the REST API chatbot. You can find permission(s) required for a Cloudflare API operation on the new Cloudflare API documentation site.

Registering above account in MechCloud

Follow the instructions under Systems Agent section to register the account created above in MechCloud.

Prompts for Supported Operations

Accounts

Listing accounts

list all the accounts

Custom Lists

Listing custom lists under an account

show all lists under '<account_id>' account

Listing all items under a custom list

show all items under '<list_id>' list of '<account_id>' account

Adding items uner a custom list

Replace all items under '<list_id>' list of '<account_id>' account with following items. each line below contains an ip address and associated comment separated by | -

@CURRENT_IP | Office
some_other_ip | system1

CURRENT_IP is a special variable which will be replaced with the ip of the machine where this prompt will be executed from.

References

Title	Links
New Cloudflare API Docs	https://developers.cloudflare.com/api-next/
Cloudflare API Token Permissions	https://developers.cloudflare.com/fundamentals/api/reference/permissions