Skip to content

Commit 7599ac2

Browse files
committedFeb 26, 2024·
updates text and moves section
1 parent 46555fb commit 7599ac2

File tree

1 file changed

+18
-18
lines changed

1 file changed

+18
-18
lines changed
 

‎content/docs/integrations.mdx

+18-18
Original file line numberDiff line numberDiff line change
@@ -86,10 +86,24 @@ Unless defined by the directory structure of a supplied archive file, the Record
8686

8787
**Foreign Key** is used to map an authorization evaluation to the corresponding record. The supported values are:
8888

89-
- `user.id` (Also the default if no value is provided),
90-
- `user.email`,
91-
- `request.ip`,
92-
- `device.id`.
89+
- `user.id` (Also the default if no value is provided)
90+
- `user.email`
91+
- `request.ip`
92+
- `device.id`
93+
94+
#### IP range lookup support
95+
96+
Pomerium supports Classless Inter-Domain Routing (CIDR) indexing when filtering a list of records with the `request.ip` foreign key. This allows you to match against IP address ranges instead of manually importing records for individual IP addresses.
97+
98+
To filter with CIDR indexing, add a special `$index` key to your external data source records. For example:
99+
100+
```json
101+
{
102+
"$index": {"cidr": "1.2.3.4/5"}
103+
}
104+
```
105+
106+
See the [GeoIP Ranges](/docs/integrations/geoip) and [Well-Known IP Ranges](/docs/integrations/ip-ranges) guides for specific examples.
93107

94108
### Headers
95109

@@ -112,17 +126,3 @@ If a job may not complete within the `min delay` period, it would be interrupted
112126
### Client TLS Key
113127

114128
For data sources using mTLS, you can select a [client certificate](/docs/concepts/certificates) (added under **Manage****Certificates**) to provide to the data source.
115-
116-
## IP range lookup support
117-
118-
Pomerium supports Classless Inter-Domain Routing (CIDR) indexing to improve database querying performance. This is useful if you're importing a list of records containing IP ranges.
119-
120-
CIDR indexing follows this format:
121-
122-
```json
123-
{
124-
"$index": {"cidr": "1.2.3.4/5"}
125-
}
126-
```
127-
128-
See the [GeoIP Ranges](/docs/integrations/geoip) and [Well-Known IP Ranges](/docs/integrations/ip-ranges) guides for specific examples.

0 commit comments

Comments
 (0)
Please sign in to comment.