From 5e46d1483292c01c71c92796d0d87012fac29cae Mon Sep 17 00:00:00 2001 From: ambrishest Date: Wed, 12 Jul 2023 17:07:17 +0100 Subject: [PATCH] Fixed mistakes in README files Issue-ID: NONRTRIC-887 Signed-off-by: ambrishest Change-Id: I0b6ccc5f67e9b4dca8df4e88101edf79777c7de0 --- capifcore/README.md | 42 +++++++++++++++++++++--------------------- invoker/README.md | 38 +++++++++++++++++++------------------- provider/README.md | 34 +++++++++++++++++----------------- 3 files changed, 57 insertions(+), 57 deletions(-) diff --git a/capifcore/README.md b/capifcore/README.md index 38a0aa2..f773802 100644 --- a/capifcore/README.md +++ b/capifcore/README.md @@ -1,44 +1,44 @@ # O-RAN-SC Non-RealTime RIC CAPIF Core implementation -This product is a Go implementation of the CAPIF Core function, based on the 3GPP "29.222 Common API Framework for 3GPP Northbound APIs (CAPIF)" interfaces, see https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3450. +This product is a Go implementation of the CAPIF Core function, which is based on the 3GPP "29.222 Common API Framework for 3GPP Northbound APIs (CAPIF)" interfaces, see https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3450. -The, almost, complete data model for CAPIF is shown in the diagram below. +The nearly complete data model for CAPIF is shown in the diagram below. -The data used within CAPIF Core for registering rApps that both provides and consumes services is shown in the diagram below. +The data used within CAPIF Core for registering rApps that provide and consume services is shown in the diagram below. Some examples of interactions between components using the CAPIF interface are shown in the sequence diagram below. -***NOTE!*** It has not been decided that CAPIF Core will actually do the Helm chart installation. This is just provided in the prototype as an example of what CAPIF Core could do. +***NOTE!*** It has not been decided that CAPIF Core will actually handle the Helm chart installation. The prototype includes this as an example of what CAPIF Core could potentially do. -If Helm is used, before publishing a service, the chart that belongs to the service must be registered in ChartMuseum. When publishing the service the following information should be provided in the `ServiceAPIDescription::description` attribute; "namespace", "repoName", "chartName", "releaseName". An example of the information: "Description of rApp helloWorld,namespace,repoName,chartName,releaseName". +If Helm is used, before publishing a service, the chart belonging to the service must be registered in ChartMuseum. When publishing the service the following information should be provided in the `ServiceAPIDescription::description` attribute; "namespace", "repoName", "chartName", "releaseName". An example of the information: "Description of rApp helloWorld,namespace,repoName,chartName,releaseName". ## Generation of API code @@ -70,7 +70,7 @@ For the CAPIF specification "TS29222_CAPIF_Discover_Service_API" a new dependenc ### Security in CAPIF -Security requirements that are applicable to all CAPIF entities includes provide authorization mechanism for service APIs from the 3rd party API providers and support a common security mechanism for all API implementations to provide confidentiality and integrity protection. +The security requirements applicable to all CAPIF entities include providing an authorization mechanism for service APIs from third-party API providers and supporting a common security mechanism for all API implementations to ensure confidentiality and integrity protection. In the current implementation Keycloak is being used as identity and access management (IAM) solution that provides authentication, authorization, and user management for applications and services. Keycloak provides robust authentication mechanisms, including username/password, two-factor authentication, and client certificate authentication that complies with CAPIF security requirements. diff --git a/invoker/README.md b/invoker/README.md index e8d3e68..c979336 100644 --- a/invoker/README.md +++ b/invoker/README.md @@ -1,30 +1,30 @@ # O-RAN-SC Non-RealTime RIC CAPIF Invoker Stub -This is a Go implementation of a stub for the CAPIF Invoker function, based on the 3GPP "29.222 Common API Framework for 3GPP Northbound APIs (CAPIF)" interfaces, see https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3450. +This is a Go implementation of a stub for the CAPIF Invoker function, which is based on the 3GPP "29.222 Common API Framework for 3GPP Northbound APIs (CAPIF)" interfaces, see https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3450. -This stub offers an user interface that helps to test the functionalities implemented in the O-RAN-SC CAPIF implementation and the supported features are the following: +This stub offers a user interface that helps to test the functionalities implemented in the O-RAN-SC CAPIF implementation and the supported features are as follows: - Onboard API Invoker - Discover published service APIs and retrieve a collection of APIs according to certain filter criteria. @@ -37,7 +37,7 @@ This service operation is used by an API invoker to on-board itself as a recogni -To onboard itself the Invoker should send a request to the CAPIF core including an API invoker Enrolment Details, API List and a Notification Destination URI for on-boarding notification. +To onboard, the Invoker should send a request to the CAPIF core, including an API invoker Enrolment Details, API List and a Notification Destination URI for on-boarding notification. ``` { @@ -54,7 +54,7 @@ To onboard itself the Invoker should send a request to the CAPIF core including } ``` -After receiving the request, the CAPIF core should check if the invoker can be onboard. In case it can be onboard, the CAPIF core will create the API invoker Profile consisting of an API invoker Identifier, Authentication Information, Authorization Information and CAPIF Identity Information. In this implementation, Keycloak is used to manage identity information. +After receiving the request, the CAPIF core should check if the invoker can be onboarded. If the invoker is eligible for onboarding, the CAPIF core will create the API invoker Profile, which includes an API invoker Identifier, Authentication Information, Authorization Information, and CAPIF Identity Information. Keycloak is utilized in this implementation to manage identity information. ### Discover published service APIs and retrieve a collection of APIs according to certain filter criteria. diff --git a/provider/README.md b/provider/README.md index cd0e2a9..9f3c6e4 100644 --- a/provider/README.md +++ b/provider/README.md @@ -1,28 +1,28 @@ # O-RAN-SC Non-RealTime RIC CAPIF Provider Stub -This is a Go implementation of a stub for the CAPIF Provider function, based on the 3GPP "29.222 Common API Framework for 3GPP Northbound APIs (CAPIF)" interfaces, see https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3450. +This is a Go implementation of a stub for the CAPIF Provider function, which is based on the 3GPP "29.222 Common API Framework for 3GPP Northbound APIs (CAPIF)" interfaces, see https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3450. This stub offers a user interface that helps to test the functionalities implemented in the O-RAN-SC Capif implementation and the supported features are the following: @@ -75,7 +75,7 @@ The request from the provider domain should include API provider Enrolment Detai } ``` -The CAPIF core proceeds to register the provider and creates Ids for the API provider domain functions that will be return as part as the response message. +The CAPIF core proceeds to register the provider and creates Ids for the API provider domain functions that will be return as part of the response message. ### Publish a new API -- 2.16.6