Skip to content
Snippets Groups Projects
sdk-configuration.md 5.74 KiB
Newer Older
JorgeEcheva26's avatar
JorgeEcheva26 committed
## OpenCAPIF SDK configuration

### **1. Configuration via Config.json**
JorgeEcheva26's avatar
JorgeEcheva26 committed

This configuration could also be fullfilled by enviroment variables (EXAMPLE)

 - invoker_folder: The path (relative or absolute) of the folder you want to store your invoker information

- provider_folder:The path (relative or absolute) of the folder you want to store your invoker information

- capif_host:The domain name of your capif host

- register_host:The domain name of your register host

- capif_https_port: The port of your capif host 

- capif_register_port:The port of your register host

- capif_callback_url:The Url you want to recieve CAPIF notifications(This functionality is not currently available) 

- csr fields: Seven information fields for generating your invoker certificate 

- capif_username: CAPIF username 

- capif_password: CAPIF password 

- APFs: Number of APF's you want to onboard as a provider Example:5 

- AEFs: Number of AEF's you want to onboard as a provider Example:2

- debug_mode: Boolean | If you want to recieve logs from SDK-S6G Example:True/False


JorgeEcheva26's avatar
JorgeEcheva26 committed
Mandatory fields no matter the target role to be onboarded, either invoker or provider:

- capif_host
- register_host
- capif_https_port
- capif_register_port
- capif_username
- capif_password
- debug_mode

If you want to use SDK as an **Invoker** you need to fill out these fields

- invoker_folder
- capif_callback_url
- csr_information(csr_common_name,csr_country_name...)

If you want to use SDK as a **Provider** you need to fill out these fields

- provider_folder
- APFs
- AEFs
     
### **2. Configuration of Publish.json**
This configuration file is only mandatory if we want to use the [CAPIF_Publish_Service_API](https://github.com/jdegre/5GC_APIs/blob/Rel-18/TS29222_CAPIF_Publish_Service_API.yaml) 
   - serviceApiId: The Api id we want to use Example "02eff6e1b3a8f7c8044a92ee8a30bd"
   - publisherAPFid: APF id we chose to use Example : "APFa165364a379035d14311deadc04332"
   - publisherAEFsids: Array of strings filled out of AEFs ids we want to use Example:        ["AEFfa38f0e855bffb420e4994ecbc8fb9","AEFe8bfa711f4f0c95ba0b382508e6382"]
JorgeEcheva26's avatar
JorgeEcheva26 committed

ServiceApiId is required in:
-  Provider Unpublish Api
-  Provider Update Api
-  Provider Get api

PublisherAPFid is required in:

-  Provider Publish Api
-  Provider Unpublish Api
-  Provider Update Api
-  Provider Get Api
-  Provider Get all Apis

PublisherAEFsids is required in:

-   Provider Publish Api
-   Provider Unpublish Api
-   Provider Update Api



For using the Publish Api function or the Update function the provider_api_description_sample.json **must** have been  modified with the Publish API that is wanted to share following the standard schema for [ServiceAPIDescription](https://github.com/jdegre/5GC_APIs/blob/Rel-18/TS29222_CAPIF_Publish_Service_API.yaml)

**AefIds fields won't need to fill out the  from aefProfiles** array because you would already be configurating this fields by completing publisherAEFsids parameter

**If the publisherAEFsids parameter don't match with the aefProfiles you will recieve an error**
JorgeEcheva26's avatar
JorgeEcheva26 committed

### Important information for Provider consumer

In the `provider_folder`, it will be located several folders with each `capif_username` you have onboarded as a provider, for each folder it is created by SDK this files:
- `Capif_provider_details.json` : Contains all the APFs and AEFs ids that have already onboarded with this capif_username
- `CAPIF_provider_api_description_sample.json` : If it's already published or updated an API, It will be available a copy of your last payload.
- `Service_received.json` : If it's alread used the get an api or get all apis functionality, It will be available the response to your request.
- `Published-Apis.json` : Constains the currently published APIs with their ApiId
#### **Configuration of Discover_filter.json**
JorgeEcheva26's avatar
JorgeEcheva26 committed
This file follows the parameters schema from the GET petition of  [Discover Services API](https://github.com/jdegre/5GC_APIs/blob/Rel-18/TS29222_CAPIF_Discover_Service_API.yaml) 

To use this feature it has to be completed `Discover_filter.json` with the parameters you want to be filtered in order to run the Invoker Service Discovery Functionality.
To run the Invoker Service Discovery Functionality it has to be onboarded as an Invoker before the CAPIF user.
JorgeEcheva26's avatar
JorgeEcheva26 committed

### Important information for Invoker consumer

In the `invoker_folder`, it will be located several folders with each `capif_username` you have onboarded as a provider. For each folder, you could find:
JorgeEcheva26's avatar
JorgeEcheva26 committed

-   `Capif_api_security_context_details.json`: This file contains the information of your invoker. It will contain:
        
    1. Your `api_invoker_id`.
    2. If you have already used the Service Discovery Functionality, you will find all the available APIs with their information.
    3. If you have already used the Service Get Token functionality, you will find your access token for using the APIs you have already discovered.



#### **Configuration of Register.json**

In order to use this SDK in a Local enviroment and creating and removing users, its mandatory to fullfill this fields.
This Feature is not included in the SDK.
- register_host:The domain name of your register host
- capif_register_port: The port of your register host
- capif_register_username: CAPIF admin username
- capif_register_password: CAPIF admin password
- capif_username: CAPIF user username
- capif_password: CAPIF user password
- config_path: Absolute path to the Config_files folder
- uuid: UUID for Deregistering the user
JorgeEcheva26's avatar
JorgeEcheva26 committed


This file is only used for the Functionalities of :
- Register and login 
- Deregister and login

Each field is obligatory to complete except UUID, which is only obligatory in case of Deregistering the user.

Although this field is not obligatory we recomend to store the UUID parameter recieved by the Register and login functionality in this field.