README.md

strongDM SDK for Java

This is the official strongDM SDK for the Java programming language.

Learn more with our 📚strongDM API docs or 📓browse the SDK reference.

Installation

Gradle:

repositories {
    mavenCentral()
}

dependencies {
    compile "io.github.strongdm:strongdm-sdk-java:${strongdm.version}"
	...

strongDM uses semantic versioning. We do not guarantee compatibility between major versions. Be sure to use version constraints to pin your dependency to the desired major version of the strongDM SDK.

Authentication

If you don't already have them you will need to generate a set of API keys, instructions are here: API Credentials

Add the keys as environment variables; the SDK will need to access these keys for every request.

$ export SDM_API_ACCESS_KEY=<YOUR ACCESS KEY>
$ export SDM_API_SECRET_KEY=<YOUR SECRET KEY>

List Users

The following code lists all registered users:

try {
	client = new Client(System.getenv("SDM_API_ACCESS_KEY"),System.getenv("SDM_API_SECRET_KEY"));
	Iterable<Account> resp = client.accounts().list("");
	for (Account n : resp) {
		if (n instanceof User) {
			User u = (User)n;
			System.out.println(u.getEmail());
		}
	}
} catch (Exception e) {
	e.printStackTrace();
}

Useful Links

• Documentation: javadoc
• Migrating from v2 to v3
• Migrating from Role Grants to Access Rules
• Examples: GitHub - strongdm/strongdm-sdk-java-examples
  1. Managing Resources
  2. Managing Accounts
  3. Managing Roles
  4. Managing Gateways

License

Apache 2

Contributing

Currently, we are not accepting pull requests directly to this repository, but our users are some of the most resourceful and ambitious folks out there. So, if you have something to contribute, find a bug, or just want to give us some feedback, please email [email protected].