The 5GMS architecture may support the Common API Framework (CAPIF) as specified in
TS 23.222 for the interactions across security trust boundaries defined in
clause 4.11.2.
Aligned with the provisions for securing northbound APIs defined in
TS 33.122, access to the provisioning operations of the 5GMS AF at reference point M1 may be authorised by means of the OAuth 2.0 framework defined in
RFC 6749. In this case, the CAPIF core function defined in
TS 23.222 plays the role of authorization server, the 5GMS AF plays the role of resource server and the 5GMS Application Provider plays the role of client.
When CAPIF is supported at reference point M1, the 5GMS Application Provider in the Trusted or External DN shall be authenticated and authorised by the CAPIF core function before it is permitted to create, modify or remove the provisioned services in the trusted 5GMS AF at reference point M1. To successfully invoke provisioning operations at reference point M1, the 5GMS Application Provider is required to present a valid access token that has previously been issued to it by the CAPIF core function at CAPIF-1/1e.
for 5GMS Application Provider provisioning trusted 5GMS AF
When CAPIF is supported at reference point M1, then:
-
The 5GMS AF shall support the CAPIF API provider domain functions (i.e. CAPIF-2/2e, CAPIF-3, CAPIF-4 and CAPIF-5 as specified in TS 23.222).
-
The Maf_Provisioning service shall be exposed to the 5GMS Application Provider at reference point CAPIF-2/2e, realising reference point M1.
Procedures for provisioning access to the 5GMS AF are defined in
clause 5.3.3 (downlink media streaming) and
6.2.2.3 (uplink media streaming).
Aligned with the provisions for securing northbound APIs defined in
TS 33.122, access to the configuration operations of the 5GMS AS at reference point M3 may be authorised by means of the OAuth 2.0 framework defined in
RFC 6749. In this case, the CAPIF core function defined in
TS 23.222 plays the role of authorization server, the 5GMS AS plays the role of resource server and the 5GMS AF plays the role of client.
When CAPIF is supported at reference point M3, the 5GMS AF in the Trusted or External DN shall be authenticated and authorised by the CAPIF core function before it is permitted to create, modify or remove the configurations in the trusted 5GMS AS at reference point M3. To successfully invoke configuration operations at reference point M3, the 5GMS AF is required to present a valid access token that has previously been issued to it by the CAPIF core function at CAPIF-1/1e.
for 5GMS AF provisioning trusted 5GMS AS
When CAPIF is supported at reference point M3, then:
-
The 5GMS AS shall support the CAPIF API provider domain functions (i.e. CAPIF-2/2e, CAPIF-3, CAPIF-4 and CAPIF-5 as specified in TS 23.222).
-
The Mas_Configuration service shall be exposed to the 5GMS AF at reference point CAPIF-2/2e, realising reference point M3.
Procedures for configuring the 5GMS AS with authorisation are defined in
clause 5.4.2 (downlink media streaming) and
6.2.3.3 (uplink media streaming).
Aligned with the provisions for securing southbound APIs defined in
TS 23.222 access to the media session handling operations of the 5GMS AF at reference point M5 may be authorised by means of the OAuth 2.0 framework defined in
RFC 6749. In this case, either the CAPIF core function defined in
TS 23.222 or the 5GMS Application Provider plays the role of authorization server, the 5GMS AF plays the role of resource server and the Media Session Handler plays the role of client.
When CAPIF is supported at reference point M5, the Resource owner-aware Northbound API Access (RNAA) model is recommended as defined in
clause 6.2.3 of TS 23.222. The Media Session Handler in the 5GMS Client shall be authenticated and authorised by the CAPIF core function before it is permitted to invoke media session handling operations on the 5GMS AF at reference point M5. To successfully invoke media session handling operations at reference point M5, the Media Session Handler in the 5GMS Client is required to present a valid access token that has previously been issued to it by the CAPIF core function at CAPIF-1e.
for a 5GMS Client accessing the 5GMS AF
When CAPIF is supported at reference point M5, then:
-
The 5GMS AF shall support the CAPIF API provider domain functions (i.e. CAPIF-2e, CAPIF-3, CAPIF-4 and CAPIF-5 as specified in TS 23.222).
-
The Maf_SessionHandling service shall be exposed to the Media Session Handler in the 5GMS Client at reference point CAPIF-2e, realising reference point M5.
Procedures used by the 5GMS Application Provider to provision future access to the 5GMS AF by Media Session Handlers are defined in
clause 5.3.3 (downlink media streaming) and
6.2.2.3 (uplink media streaming).
Procedures for authorising access to the 5GMS AF by the Media Session Handler under the control of the 5GMS-Aware Application are defined in
clause 5.2.5 (downlink media streaming) and
6.3.3 (uplink media streaming).