Skip to content

Commit daf4e0c

Browse files
appsdeshapoorvadeshpande-okta
authored andcommitted
IP Addresses as a format
IP Addresses as a format
1 parent 132857b commit daf4e0c

File tree

2 files changed

+26
-10
lines changed

2 files changed

+26
-10
lines changed

openid-caep-1_0.md

-10
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,6 @@ author:
2929
3030

3131
normative:
32-
RFC4001: # Textual Conventions for Internet Network Addresses
33-
3432
ISO-IEC-29115:
3533
target: http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=45138
3634
title: "ISO/IEC 29115:2013 -- Information technology - Security techniques - Entity authentication assurance framework"
@@ -735,9 +733,6 @@ The `event_timestamp` in this event type specifies the time at which the session
735733
### Event Specific Claims {#session-established-event-specific-claims}
736734
The following optional claims MAY be included in the Session Established event:
737735

738-
ips
739-
: The array of IP addresses of the user as observed by the Transmitter. The value MUST be in the format of an array of strings, each one of which represents the RFC 4001 {{RFC4001}} string representation of an IP address. (**NOTE**, this can be different from the one observed by the Receiver for the same user because of network translation)
740-
741736
fp_ua
742737
: Fingerprint of the user agent computed by the Transmitter. (**NOTE**, this is not to identify the session, but to present some qualities of the session)
743738

@@ -767,7 +762,6 @@ The following is a non-normative example of the `session-established` event type
767762
},
768763
"events": {
769764
"https://schemas.openid.net/secevent/caep/event-type/session-established": {
770-
"ips": ["192.168.1.12", "10.1.1.1"],
771765
"fp_ua": "abb0b6e7da81a42233f8f2b1a8ddb1b9a4c81611",
772766
"acr": "AAL2",
773767
"amr": ["otp"],
@@ -790,9 +784,6 @@ The Session Presented event signifies that the Transmitter has observed the sess
790784
### Event Specific Claims {#session-presented-event-specific-claims}
791785
The following optional claims MAY be present in a Session Presented event:
792786

793-
ips
794-
: The array of IP addresses of the user as observed by the Transmitter. The value MUST be in the format of an array of strings, each one of which represents the RFC 4001 {{RFC4001}} string representation of an IP address. (**NOTE**, this can be different from the one observed by the Receiver for the same user because of network translation)
795-
796787
fp_ua
797788
: Fingerprint of the user agent computed by the Transmitter. (**NOTE**, this is not to identify the session, but to present some qualities of the session)
798789

@@ -815,7 +806,6 @@ The following is a non-normative example of a Session Presented event:
815806
},
816807
"events": {
817808
"https://schemas.openid.net/secevent/caep/event-type/session-presented": {
818-
"ips": ["192.168.1.12","10.1.1.1"],
819809
"fp_ua": "abb0b6e7da81a42233f8f2b1a8ddb1b9a4c81611",
820810
"ext_id": "12345",
821811
"event_timestamp": 1615304991643

openid-sharedsignals-framework-1_0.md

+26
Original file line numberDiff line numberDiff line change
@@ -115,6 +115,7 @@ normative:
115115
RFC8936:
116116
RFC9110:
117117
RFC9493:
118+
RFC4001:
118119
CAEP:
119120
author:
120121
-
@@ -386,6 +387,31 @@ Subject Identifier Format.
386387
"assertion_id": "_8e8dc5f69a98cc4c1ff3427e5ce34606fd672f91e6"
387388
}
388389

390+
~~~
391+
{: #sub-id-ips title="Example: 'ips' Subject Identifier"}
392+
393+
### IP Addresses Subject Identifier Format {#sub-id-ips}
394+
395+
The "IP addresses" Subject Identifier Format specifies an array of IP addresses observed by the Transmitter.
396+
Subject Identifiers of this format MUST contain the following members:
397+
398+
ip-addresses
399+
400+
> REQUIRED. The array of IP addresses of the subject as observed by the Transmitter. The value MUST be in the format of an array of strings, each one of which represents the {{RFC4001}} string representation of an IP address.
401+
402+
403+
The "IP addresses" Subject Identifier Format is identified by the name
404+
"ip-addresses".
405+
406+
Below is a non-normative example of Subject Identifier for the "IP addresses"
407+
Subject Identifier Format.
408+
409+
~~~ json
410+
{
411+
"format": "ip-addresses",
412+
"ip-addresses": ["10.29.37.75", "2001:0db8:0000:0000:0000:8a2e:0370:7334"]
413+
}
414+
389415
~~~
390416
{: #sub-id-samlassertionid title="Example: 'saml_assertion_id' Subject Identifier"}
391417

0 commit comments

Comments
 (0)