Skip to content

Commit 8f83051

Browse files
authored
IP Addresses as a format (#237)
IP Addresses as a format
1 parent 40a9f75 commit 8f83051

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: https://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"
@@ -739,9 +737,6 @@ The `event_timestamp` in this event type specifies the time at which the session
739737
### Event Specific Claims {#session-established-event-specific-claims}
740738
The following optional claims MAY be included in the Session Established event:
741739

742-
ips
743-
: 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)
744-
745740
fp_ua
746741
: 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)
747742

@@ -771,7 +766,6 @@ The following is a non-normative example of the `session-established` event type
771766
},
772767
"events": {
773768
"https://schemas.openid.net/secevent/caep/event-type/session-established": {
774-
"ips": ["192.168.1.12", "10.1.1.1"],
775769
"fp_ua": "abb0b6e7da81a42233f8f2b1a8ddb1b9a4c81611",
776770
"acr": "AAL2",
777771
"amr": ["otp"],
@@ -794,9 +788,6 @@ The Session Presented event signifies that the Transmitter has observed the sess
794788
### Event Specific Claims {#session-presented-event-specific-claims}
795789
The following optional claims MAY be present in a Session Presented event:
796790

797-
ips
798-
: 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)
799-
800791
fp_ua
801792
: 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)
802793

@@ -819,7 +810,6 @@ The following is a non-normative example of a Session Presented event:
819810
},
820811
"events": {
821812
"https://schemas.openid.net/secevent/caep/event-type/session-presented": {
822-
"ips": ["192.168.1.12","10.1.1.1"],
823813
"fp_ua": "abb0b6e7da81a42233f8f2b1a8ddb1b9a4c81611",
824814
"ext_id": "12345",
825815
"event_timestamp": 1615304991643

openid-sharedsignals-framework-1_0.md

+26
Original file line numberDiff line numberDiff line change
@@ -121,6 +121,7 @@ normative:
121121
RFC8936:
122122
RFC9110:
123123
RFC9493:
124+
RFC4001:
124125
CAEP:
125126
author:
126127
-
@@ -392,6 +393,31 @@ Subject Identifier Format.
392393
"assertion_id": "_8e8dc5f69a98cc4c1ff3427e5ce34606fd672f91e6"
393394
}
394395

396+
~~~
397+
{: #sub-id-ips title="Example: 'ips' Subject Identifier"}
398+
399+
### IP Addresses Subject Identifier Format {#sub-id-ips}
400+
401+
The "IP addresses" Subject Identifier Format specifies an array of IP addresses observed by the Transmitter.
402+
Subject Identifiers of this format MUST contain the following members:
403+
404+
ip-addresses
405+
406+
> 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.
407+
408+
409+
The "IP addresses" Subject Identifier Format is identified by the name
410+
"ip-addresses".
411+
412+
Below is a non-normative example of Subject Identifier for the "IP addresses"
413+
Subject Identifier Format.
414+
415+
~~~ json
416+
{
417+
"format": "ip-addresses",
418+
"ip-addresses": ["10.29.37.75", "2001:0db8:0000:0000:0000:8a2e:0370:7334"]
419+
}
420+
395421
~~~
396422
{: #sub-id-samlassertionid title="Example: 'saml_assertion_id' Subject Identifier"}
397423

0 commit comments

Comments
 (0)