Switch branches/tags
Nothing to show
Find file History
craiglurey Merge pull request #86 from Keeper-Security/dev/sk
PsPasswd plugin. Double quote fix
Latest commit 854bb40 Sep 26, 2018

README.md

Keeper Commander Plugins

Commander's open source plugin architecture provides auto-login and password rotation services into any target platform. Commander can securely rotate passwords in your Keeper vault and then automatically synchronize the change to all users and devices with privileged access to the record. Using our connector plugins, you can then perform the password reset directly on the source (e.g. the database, active directory, etc.).

Using Commander to rotate passwords, combined with the flexibility of Keeper's secure record sharing features provides you with the most secure and flexible way to grant and revoke access to highly sensitive data.

Supported Plugins

  • Active Directory

  • Unix Logins

  • Windows Logins

  • MySQL, Oracle, PostgreSQL, SQL Server

  • ... and more to come.

Activating a Plugin

To activate a plugin for a particular Keeper record, you first need to update the custom fields for that record with special keywords that are used by Commander. For example, here is a MySQL database record:

Now on the command line you can use the download command to pull down your changes...

Then get to view the record info.

Each Keeper record has a unique Record UID. In this example, the record UID is VEpovl5St-MPcnNrfJkyDg. When a plugin is specified in a record, Commander will search in the plugins/ folder to load the module based on the name provided. In this case, it will use the mysql.py plugin.

At this point, to perform a rotation just use the rotate command. For example in this case:

r VEpovl5St-MPcnNrfJkyDg

Keeper's team is expanding the number of plugins on an ongoing basis. If you need a particular plugin created, email us at ops@keepersecurity.com.

Auto-command execution

You can automate password resets using a plugin

Example:

{                                                                               
    "debug":false,
    "server":"https://keepersecurity.com/api/v2/",
    "user":"admin@company.com",
    "password":"somereallystrongpassword",
    "commands":["d", "r 3PMqasi9hohmyLWJkgxCWg"]
}

In this example, we are telling Commander to first download and decrypt records, then reset a password. The custom fields in the record give the plugin the information it needs to rotate the password appropriately. As you can see, each unique password record in the Keeper system is represented by a unique record UID. Use the "l" or "s" command in Commander's interactive mode to display the record UIDs in your account.

Another way to do a rotation would be to call rotate command from the command line:

keeper rotate --uid 3PMqasi9hohmyLWJkgxCWg