Implemented guardrail service with APIs to effectively manage guardrails in the system #160

[vinayakbagal7]

Change Description

Implemented guardrail service with APIs to effectively manage guardrails in the system

1. Added APIs to handle all CRUD operations for guardrail connections.

Example payload -

{
   "name": "gr_connection_1",
   "description": "test description",
   "guardrailsProvider": "AWS",
   "connectionDetails": {
       "access_key": "<aws_access_key>",
       "secret_key": "<aws_secret_ky>",
       "session_token": "<aws_session_token>"
   },
   "encryptFields": ["secret_key", "session_token"]
}

2. API to test connections to external services with the same payload as above.
3. APIs to handle all CRUD operations for guardrails.
4. Handled different types of configurations below in the guardrail.

1. Content Moderation
2. Off Topics filters
3. Denied Terms
4. Sensitive Data Filtering
5. Prompt Safety

Example payload for guardrail -

{
   "name": "test_gr_1",
   "description": "test guardrail 1",
   "version": 1,
   "applicationKeys": [
       "632bc4a449580d9766f5845179bb8b6e",
       "6b2d2f21acdac859d3fb3804484b99a7",
       "5c4c5df2daca1210f34120af6c689187"
   ],
   "guardrailConnectionName": "gr_connection_1",
   "guardrailProvider": "AWS",
   "guardrailConfigs": [
       {
           "configType": "CONTENT_MODERATION",
           "responseMessage": "I couldn't respond to that message.",
           "configData": {
               "configs": [
                   {
                       "category": "Hate",
                       "filterStrengthPrompt": "high",
                       "filterStrengthResponse": "medium"
                   },
                   {
                       "category": "Insults",
                       "filterStrengthPrompt": "high",
                       "filterStrengthResponse": "medium"
                   }
               ]
           }
       },
       {
           "configType": "SENSITIVE_DATA",
           "responseMessage": "I couldn't respond to that message.",
           "configData": {
               "configs": [
                   {
                       "category": "EMAIL",
                       "action": "DENY"
                   },
                   {
                       "category": "USERNAME",
                       "action": "ALLOW"
                   },
                   {
                       "category": "PASSWORD",
                       "action": "REDACT"
                   },
                   {
                       "type": "regex",
                       "name": "email_regex",
                       "description": "email_regex",
                       "pattern": "test_pattern",
                       "action": "REDACT"
                   }
               ]
           }
       },
       {
           "configType": "OFF_TOPIC",
           "responseMessage": "I couldn't respond to that message.",
           "configData": {
               "configs": [
                   {
                       "topic": "Sports",
                       "definition": "Sports Definition",
                       "samplePhrases": [
                           "Who's playing NFL tonight ?",
                           "Who's leading tonight ?"
                       ],
                       "action": "DENY"
                   }
               ]
           }
       },
       {
           "configType": "DENIED_TERMS",
           "responseMessage": "I couldn't respond to that message.",
           "configData": {
               "configs": [
                   {
                       "type": "PROFANITY",
                       "value": true
                   },
                   {
                       "term": "Violance",
                       "keywords": [
                           "Violent Bahaviour",
                           "Physical Assault"
                       ]
                   }
               ]
           }
       },
       {
           "configType": "PROMPT_SAFETY",
           "responseMessage": "I couldn't respond to that message.",
           "configData": {
               "configs": [
                   {
                       "category": "PROMPT_ATTACK",
                       "filterStrengthPrompt": "HIGH"
                   }
               ]
           }
       }
   ]
}

5. CRUD API to manage response message templates.

6. "Get Guardrail" API specifically for the shield service based on lastKnownVersion.
   Example response -

{
   "applicationKey": "632bc4a449580d9766f5845179bb8b6e",
   "version": 3,
   "guardrails": [
       {
           "id": 1,
           "status": 1,
           "createTime": "2024-12-20T08:46:36.899617",
           "updateTime": "2024-12-20T08:52:36.900342",
           "name": "test_gr_1",
           "description": "test guardrail 1",
           "version": 6,
           "guardrailProvider": "AWS",
           "guardrailConnectionName": "gr_connection_1",
           "guardrailConfigs": [
               {
                   ...
               }
           ],
           "guardrailProviderResponse": {
               "success": true,
               "response": {
                   "guardrailId": "j0vwca4b8swg",
                   "guardrailArn": "arn:aws:bedrock:us-east-1:404161567776:guardrail/j0vwca4b8swg",
                   "version": "DRAFT"
               }
           },
           "guardrailConnectionDetails": {
               "access_key": "<aws_secret_key>",
               "secret_key": "<aws_secret_key_encrypted>",
               "session_token": "<aws_session_token_encrypted>",
               "encryption_key_id": <id>
           }
       }
   ]
}

Issue reference

This PR fixes issue #160

Checklist

• I have reviewed the contribution guidelines
• My code includes unit tests
• All unit tests and lint checks pass locally
• My PR contains documentation updates/additions if required

[akshayr-privacera-github]

Lets do the required changes