NationalSecurityAgency/datawave-modification-service

Java

3

23 commits

updated Jan 28, 2025

See the code

README

Modification Service

Apache License Build Status

The Dictionary service provides access to the modification api. Based on the datawave metadata, certain fields are modifiable (e.g. a document comment field) by users using this service.

Root Context

https://host:port/modification/


Modification

The root context for all modification operations is https://host:port/modification/v1/

MethodOperationDescriptionRequest Body
GET/Retrieves the data dictionaryN/A
GET/DescriptionsRetrieves all descriptions from the dictionaryN/A
GET/Descriptions/{datatype}Retrieves all descriptions for a data type from the dictionaryN/A
GET/Descriptions/{datatype}/{fieldname}Retrieves from the dictionary the description for a field of a data typeN/A
POST/DescriptionsUploads a set of descriptions into the dictionary[DefaultFields]
PUT/Descriptions/{datatype}/{fieldName}/{description}Sets the description for a field in a datatypeN/A
POST/DescriptionsSets the description for a field in a datatypeN/A
DELETE/Descriptions/{datatype}/{fieldname}Removes the description from a field of a data typeN/A

Getting Started

  1. First, refer to services/README for launching the config, authorization, and audit services.

    • The authorization service should be launched with the mock profile to leverage test PKI materials and associated user configuration (see [authorization-mock.yml][auth-mock-yml]).
  2. Launch this service as follows, with the remoteauth profile to enable client cert authentication.

    java -jar service/target/modification-service*-exec.jar --spring.profiles.active=dev,remoteauth
    
  3. Ensure that the testUser.p12 (password: ChangeIt) cert is imported into your browser, and then visit any of the following:

    See sample_configuration/modification-dev.yml and configure as desired

NationalSecurityAgency/datawave-modification-service

Java

3

23 commits

updated Jan 28, 2025

See the code

README

Modification Service

Apache License Build Status

The Dictionary service provides access to the modification api. Based on the datawave metadata, certain fields are modifiable (e.g. a document comment field) by users using this service.

Root Context

https://host:port/modification/


Modification

The root context for all modification operations is https://host:port/modification/v1/

MethodOperationDescriptionRequest Body
GET/Retrieves the data dictionaryN/A
GET/DescriptionsRetrieves all descriptions from the dictionaryN/A
GET/Descriptions/{datatype}Retrieves all descriptions for a data type from the dictionaryN/A
GET/Descriptions/{datatype}/{fieldname}Retrieves from the dictionary the description for a field of a data typeN/A
POST/DescriptionsUploads a set of descriptions into the dictionary[DefaultFields]
PUT/Descriptions/{datatype}/{fieldName}/{description}Sets the description for a field in a datatypeN/A
POST/DescriptionsSets the description for a field in a datatypeN/A
DELETE/Descriptions/{datatype}/{fieldname}Removes the description from a field of a data typeN/A

Getting Started

  1. First, refer to services/README for launching the config, authorization, and audit services.

    • The authorization service should be launched with the mock profile to leverage test PKI materials and associated user configuration (see [authorization-mock.yml][auth-mock-yml]).
  2. Launch this service as follows, with the remoteauth profile to enable client cert authentication.

    java -jar service/target/modification-service*-exec.jar --spring.profiles.active=dev,remoteauth
    
  3. Ensure that the testUser.p12 (password: ChangeIt) cert is imported into your browser, and then visit any of the following:

    See sample_configuration/modification-dev.yml and configure as desired