Contact Us 1-800-596-4880

Protecting App Property Values with rtfctl

Secure application properties are added in the Runtime Fabric cluster locally, stored securely, and scoped per environment. These properties are accessible in unencrypted form by Mule applications deployed in the scoped environment as custom properties.

Runtime Fabric protected properties always take precedence over application-level properties.

Install rtfctl

The rtfctl utility is required to manage protected properties on Runtime Fabric locally. Follow the steps to install rtfctl before continuing with managing secure properties.

Set Secure Properties

  1. Log into a controller node where rtfctl is installed.

  2. Run the following command to set a secure property to the Runtime Fabric under a specific environment, substituting the placeholder fields:

    rtfctl apply secure-property --key <key> --value <value> --app-namespace <app_namespace> --namespace <rtf_namespace>
    • <key>: The key for the secure property used in the Mule application to reference the value.

    • <value>: The value for the secure property to store.

    • <app_namespace>: The Anypoint environment to scope this secure property to. Only applications deployed to this environment have access to this secure property.

    • <rtf_namespace>:System namespace scope, defaults to rtf.

View Secure Properties

  1. Log into a controller node where rtfctl is installed.

  2. Run the following command to view the secure properties applied to the Runtime Fabric under a specific environment, substituting the placeholder fields:

    sudo ./rtfctl get secure-properties -n <environment_id>
    • <environment_id>: The Anypoint environment ID to list the secure properties under.

Access Secure Properties

You can access secure properties from inside your Mule application using ${my.property.name}.

Remove Secure Properties

  1. Log into a controller node where rtfctl is installed.

  2. Run the following command to remove a secure property from the Runtime Fabric in a specific namespace:

    sudo ./rtfctl delete secure-property <my_key> -n <namespace>
    • <my_key>: The key used in the Mule application to reference the secure property.

    • <namespace>: The namespace in which the secure property applies.