Integration with gRPC

The SDK can be integrated into gRPC projects.

Start the SDK

The automatic interceptor is not supported in gRPC, so you should disable requests interception by setting the PXPolicy/urlRequestInterceptionType to PXPolicyUrlRequestInterceptionType/none.

policy.urlRequestInterceptionType = PXPolicyUrlRequestInterceptionType.NONE

📘

Read about manual integration

You should read how to work with manual integration in your app.

Adding SDK's HTTP headers to your gRPC requests

In order to include the SDK's HTTP headers in your gRPC requests, you should add them to your request's metadata.

val headers = PerimeterX.headersForURLRequest()!!
val metadata = Metadata()
for ((key, value) in headers!!) {
	metadata.put(Metadata.Key.of(key, Metadata.ASCII_STRING_MARSHALLER), value)
}

// send you gRPC request with `metadata`...

Now, use the call option instance when you call your send your gRPC request.

Handle block responses from your server

After receiving an error in the server's response, the gRPC library will throw an exception. pass the information to SDK with the PerimeterX/handleResponse(response:data:forAppId:callback:) function.

try {
	// send your gRPC request...
} catch (statusException: StatusException) {
	PerimeterX.handleResponse(statusException.status.description!!, null) { result ->
		println("challenge result = $result")
	}
}