Skip to main content

Plugins

The aserto-idp CLI includes a collections of plugins, each supporting a different identity provider format.

The plugins will be downloaded on the system in a directory under the following path: $HOME/.aserto/idpplugins .

Currently, the available plugins are:

  • aserto
  • okta
  • json
  • auth0

The plugins can be downloaded in 2 ways:

  • using the get-plugin command
  • calling the exec or delete command with the name of a plugin that is not on the system (this will automatically download the latest version of that plugin).

Get a plugin

To download the latest version of a plugin:

aserto-idp get-plugin aserto

or

aserto-idp get-plugin aserto:latest

To download a specific version of a plugin:

aserto-idp get-plugin aserto:1.0.1
note

If you don't download the plugins before using the aserto-idp exec command, the CLI will automatically download the plugins required to complete the operation.

Listing plugins

To see the plugins that are downloaded on the system and their version, the list-plugins command can be used.

To list plugins that are currently on the system:

aserto-idp list-plugins

The output will be similar to:

    auth0:v0.0.7
json:0.0.11
okta:0.0.23
aserto:0.0.11

To list plugins and versions that are available remotely and can be downloaded:

aserto-idp list-plugins --remote

The output will be similar to:

Available versions for 'okta'
* okta:0.0.23
okta:0.0.22
okta:0.0.21
okta:0.0.20

Available versions for 'json'
json:0.0.12
* json:0.0.11
json:0.0.10

Available versions for 'auth0'
auth0:0.0.7
auth0:0.0.6
auth0:0.0.5

Available versions for 'aserto'
* aserto:0.0.11
aserto:0.0.10

where * symbolize the version that is currently on the system.