Integration with gRPC [BETA]

v2.x

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/requestsInterceptedAutomaticallyEnabled to false.

1 PXPolicy.requestsInterceptedAutomaticallyEnabled = false
2 
3 // call the start function...
4 
5 let policy = PXPolicy()
6 policy.requestsInterceptedAutomaticallyEnabled = false
7 
8 // call the setPolicy function...

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.

1 let headers = PerimeterX.headersForURLRequest(forAppId: nil)
2 var callOption = CallOptions()
3 for (key, value) in headers {
4 	callOption.customMetadata.replaceOrAdd(name: key, value: value)
5 }
6 // send you gRPC request with `callOption`...

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 handleResponse function.

1 do {
2 	// send your gRPC request...
3 } catch {
4 	if let statusError = error as? GRPC.GRPCStatus, let data = statusError.message?.data(using: .utf8) {
5 		let response = HTTPURLResponse(url: URL(string: "https://your.server.domain")!, statusCode: 403, httpVersion: nil, headerFields: nil)!
6 		PerimeterX.handleResponse(forAppId: nil, data: data, response: response)
7 	}
8 }

1	PXPolicy.requestsInterceptedAutomaticallyEnabled = false
2
3	// call the start function...
4
5	let policy = PXPolicy()
6	policy.requestsInterceptedAutomaticallyEnabled = false
7
8	// call the setPolicy function...

1	let headers = PerimeterX.headersForURLRequest(forAppId: nil)
2	var callOption = CallOptions()
3	for (key, value) in headers {
4	callOption.customMetadata.replaceOrAdd(name: key, value: value)
5	}
6	// send you gRPC request with `callOption`...

1	do {
2	// send your gRPC request...
3	} catch {
4	if let statusError = error as? GRPC.GRPCStatus, let data = statusError.message?.data(using: .utf8) {
5	let response = HTTPURLResponse(url: URL(string: "https://your.server.domain")!, statusCode: 403, httpVersion: nil, headerFields: nil)!
6	PerimeterX.handleResponse(forAppId: nil, data: data, response: response)
7	}
8	}