Connectors

Castle Connector

The Castle connector lets you add additional risk signals with Castle’s fraud and risk management platform in your PingOne DaVinci flow.

You can use the Castle connector to:

  • Filter registration and login traffic to block bots and bad traffic

  • Request a risk evaluation from Castle’s API

Setup

Resources

For information and setup help, see the following:

Requirements

To use the connector, you’ll need:

  • A Castle license

  • Your Castle credentials

Setting up Castle

Follow the instructions in Castle quickstart.

Configuring the Castle connector

Add the connector in DaVinci as shown in Adding a connector, then configure it as follows.

Connector configuration

API Secret

Your 32-character Castle API secret, for example, Olc3…​YIBF.

Using the connector in a flow

Registration and Login Traffic Filtration

You can use the Filter Registration and Login Traffic capability to block bots and bad traffic early in the request chain based on context and user information.

No special configuration is needed. Add the capability and populate its properties according to the help text.

Risk evaluation

You can use the Get Risk Evaluation capability to request a risk evaluation from Castle’s API.

No special configuration is needed. Add the capability and populate its properties according to the help text.

Creating a custom API call

If you want to do something that isn’t supported by one of the provided capabilities, you can use the Make a Custom API Call capability to define your own action.

This capability uses the credentials from your connector to make an API call with the HTTP method, headers, query parameters, and body you specify.

Capabilities

Filter registration and login traffic

Used to block bots and bad traffic early in the request chain, typically at registration.

Show details
Properties
Body codeEditor required

The raw JSON body, such as "{ "Username": "jsmith@example.com", "Session ID": "00e8a0000024zkjAAA" }".

Output Schema
output object
rawResponse object
statusCode number
headers object
status string

Risk Evaluation

Used to request a risk evaluation from Castle’s API

Show details
Properties
Body codeEditor required

The raw JSON body, such as "{ "Username": "jsmith@example.com", "Session ID": "00e8a0000024zkjAAA" }".

Output Schema
output object
rawResponse object
statusCode number
headers object