https://github.com/scalekit-inc/scalekit-sdk-java
Java SDK for enterprise authentication - Spring Boot compatible SAML and OIDC integration
https://github.com/scalekit-inc/scalekit-sdk-java
authentication client-library enterprise-auth java oidc saml sdk spring-boot sso
Last synced: about 1 month ago
JSON representation
Java SDK for enterprise authentication - Spring Boot compatible SAML and OIDC integration
- Host: GitHub
- URL: https://github.com/scalekit-inc/scalekit-sdk-java
- Owner: scalekit-inc
- License: mit
- Created: 2024-06-18T13:37:13.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-09-11T11:11:28.000Z (10 months ago)
- Last Synced: 2025-09-16T09:10:42.612Z (9 months ago)
- Topics: authentication, client-library, enterprise-auth, java, oidc, saml, sdk, spring-boot, sso
- Language: Java
- Homepage: https://docs.scalekit.com/sso/quickstart?tech-stack=java
- Size: 3.12 MB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Official Java SDK for Scalekit — the auth stack for agents.
Authentication, authorization, and tool-calling for human-in-the-loop and autonomous agent flows.
[](https://search.maven.org/search?q=g:%22com.scalekit%22%20AND%20a:%22scalekit-sdk-java%22)
[](https://opensource.org/licenses/MIT)
[](https://javadoc.io/doc/com.scalekit/scalekit-sdk-java)
**[📖 Documentation](https://docs.scalekit.com)** · **[🐛 Report an Issue](https://github.com/scalekit-inc/scalekit-sdk-java/issues)** · **[💬 Join our Slack](https://join.slack.com/t/scalekit-community/shared_invite/zt-3gsxwr4hc-0tvhwT2b_qgVSIZQBQCWRw)**
---
This is the official Java SDK for [Scalekit](https://scalekit.com) — the auth stack for agents. Build secure AI products faster with authentication for humans (SSO, passwordless, full-stack auth) and agents (MCP/APIs, delegated actions), all unified on one platform.
---
### Agent-First Features
- **Agent Identity** — Agents as first-class actors with human ownership and org context
- **MCP-Native OAuth 2.1** — Purpose-built for Model Context Protocol with DCR/PKCE support
- **Ephemeral Credentials** — Time-bound, task-based authorization (minutes, not days)
- **Token Vault** — Per-user, per-tool token storage with rotation and progressive consent
- **Human-in-the-Loop** — Step-up authentication when risk crosses thresholds
- **Immutable Audit** — Track which user initiated, which agent acted, what resource was accessed
#### Human Authentication
- **Enterprise SSO** — Support for SAML and OIDC protocols
- **SCIM Provisioning** — Automated user provisioning and deprovisioning
- **Passwordless Authentication** — Magic links, OTP, and modern auth flows
- **Multi-tenant Architecture** — Organization-level authentication policies
- **Social Logins** — Support for popular social identity providers
- **Full-Stack Auth** — Complete IdP-of-record solution for B2B SaaS
---
### Getting started
#### Prerequisites
- **Java** ≥ 8
- [Scalekit account](https://scalekit.com) with `env_url`, `client_id`, and `client_secret`
#### Installation
**Gradle:**
```gradle
implementation "com.scalekit:scalekit-sdk-java:2.0.10"
```
**Maven:**
```xml
com.scalekit
scalekit-sdk-java
2.0.10
```
#### Usage
```java
import com.scalekit.ScalekitClient;
ScalekitClient scalekitClient = new ScalekitClient(
"env_url",
"client_id",
"client_secret"
);
// Use scalekitClient to interact with the Scalekit API
```
---
### Example — SSO with Spring Boot
```java
@RestController
public class AuthController {
ScalekitClient scalekitClient = new ScalekitClient("env_url", "client_id", "client_secret");
@Value("${auth.redirect.url}")
private String redirectUrl;
@PostMapping(path = "auth/login")
public RedirectView loginHandler() {
AuthorizationUrlOptions options = new AuthorizationUrlOptions();
String url = scalekitClient.authentication()
.getAuthorizationUrl(redirectUrl, options)
.toString();
return new RedirectView(url);
}
@GetMapping("auth/callback")
public String callbackHandler(@RequestParam String code, HttpServletResponse response) {
AuthenticationResponse authResponse = scalekitClient.authentication()
.authenticateWithCode(code, redirectUrl, new AuthenticationOptions());
Cookie cookie = new Cookie("access_token", authResponse.getAccessToken());
response.addCookie(cookie);
return authResponse.getIdToken();
}
}
```
---
### Example Apps
| Framework | Repository | Description |
|-----------|------------|-------------|
| **Spring Boot** | [scalekit-springboot-example](https://github.com/scalekit-developers/scalekit-springboot-example) | Complete Spring Boot integration |
---
### Helpful Links
#### Quickstart Guides
- [SSO Integration](https://docs.scalekit.com/sso/quickstart/) — Implement enterprise Single Sign-on
- [Full Stack Auth](https://docs.scalekit.com/fsa/quickstart/) — Complete authentication solution
- [Passwordless Auth](https://docs.scalekit.com/passwordless/quickstart/) — Modern authentication flows
- [Social Logins](https://docs.scalekit.com/social-logins/quickstart/) — Popular social identity providers
- [Machine-to-Machine](https://docs.scalekit.com/m2m/quickstart/) — API authentication
- [Agent Auth](https://docs.scalekit.com/agent-auth/quickstart/) — Authentication for AI agents
#### Documentation & Reference
- [API Reference](https://docs.scalekit.com/apis) — Complete API documentation
- [Developer Kit](https://docs.scalekit.com/dev-kit/) — Tools and utilities
- [API Authentication Guide](https://docs.scalekit.com/guides/authenticate-scalekit-api/) — Secure API access
#### Additional Resources
- [Setup Guide](https://docs.scalekit.com/guides/setup-scalekit/) — Initial platform configuration
- [Code Examples](https://docs.scalekit.com/directory/code-examples/) — Ready-to-use code snippets
- [Admin Portal Guide](https://docs.scalekit.com/directory/guides/admin-portal/) — Administrative interface
- [Launch Checklist](https://docs.scalekit.com/directory/guides/launch-checklist/) — Pre-production checklist
---
### Contributing
Contributions are welcome! Coming soon: contribution guidelines.
For now:
1. Fork this repository
2. Create a branch — `git checkout -b fix/my-improvement`
3. Make your changes
4. Run tests
5. Open a Pull Request
---
### License
This project is licensed under the **MIT license**. See the [LICENSE](LICENSE) file for more information.