Keymate Logo

External Integrations Made First-Class—via gRPC and REST

Keymate offers a dual-mode Event Subscription API that external systems can use to stream data into the platform. From HRMS to CRM to audit engines, build adapters in any language to push events directly into Keymate's Event Hub—securely and efficiently.

External Integrations Made First-Class—via gRPC and REST

Push External Data into the Keymate Event Hub

To power real-time decisions and observability, external events must reach Keymate safely and in a structured way. That's where the Event Subscription API comes in: Dual API support: REST (OpenAPI) and gRPC (Proto). Strong typing and schema validation. Token-based security and org-level scoping. Push or pull models—compatible with modern and legacy systems. Built-in retry logic, delivery guarantees, and error queues. Events are published directly into the Keymate Event Hub. Enables integration with internal policy checks, observability, and authorization engines. Did you know? This API is used by our Java-based producer adapters that integrate with HRMS and CRM systems. You can build your own in any language.

Event Subscription API Architecture

Secure, scalable event ingestion from external systems through dual-protocol API support with built-in reliability features.

Example: Dual-mode API for external system integration

Key Components:

gRPC & REST Support
Schema Validation
Token-Based Security
Event Hub Integration
Adapter Architecture

What Makes It Unique

Dual Protocol Support (gRPC + REST)

Choose the protocol that best fits your environment

Adapter-Friendly Architecture

Write your own producer microservices using this API

OpenAPI & Proto Definitions

Strongly typed schemas, versioned and documented

Push & Pull Modes

Support for both streaming and polling event flows

Secure Token-Based Auth

Org-scoped bearer token access for external producers

Retry and Delivery Guarantees

Retry logic, backoff, and dead-letter queue support

Event Hub Integration

All events are routed through the internal Event Hub pipeline

Fine-Grained Subscription Control

Limit access by topic, event type, org ID, and more

Frequently Asked Questions

Any external system—HRMS, CRM, security tools, analytics engines—that can produce event data.
Yes. We provide reference Java microservices that integrate with common platforms and publish events using this API.
Absolutely. This API is publicly documented and language-agnostic. Use gRPC or REST as you prefer.
They are published directly into Keymate's Event Hub, which handles routing, filtering, and policy evaluation.
Every API call requires a signed token. You can also scope tokens by organization or topic.

How to Use This Feature

Follow these steps to integrate external systems with the Event Subscription API.

Implementation Steps

1

Choose your protocol (gRPC or REST)

2

Get the latest .proto or OpenAPI spec from the Admin Console

3

Create a producer adapter in your preferred language (we use Java)

4

Authenticate via token and register your subscription or push model

5

Emit events to the Subscription API, which delivers them to the Event Hub

6

Monitor delivery and retry logic using Keymate observability tools

ELEVATE YOUR IAM STRATEGY

Ready to Transform Your Keycloak Experience?

Implement fine-grained authorization, multi-tenant infrastructure, and comprehensive security policies with Keymate — built on the Keycloak foundation you already trust.