All files / handlers/rules GetRuleHandler.ts

100% Statements 29/29
92% Branches 23/25
100% Functions 2/2
100% Lines 27/27

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112                                      1x 1x 1x 1x 1x                                                                                     1x         7x 7x   7x               7x 7x 2x         5x 5x 5x 5x 5x 5x 1x 1x     4x 4x 4x   4x 2x   2x 2x        
/* 
  Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  
  Licensed under the Apache License, Version 2.0 (the "License").
  You may not use this file except in compliance with the License.
  You may obtain a copy of the License at
  
      http://www.apache.org/licenses/LICENSE-2.0
  
  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
*/
 
import { APIGatewayProxyEvent, Context } from 'aws-lambda';
import { Logger, LoggerFactory } from 'shared_types';
import { AsyncRequestHandler } from 'src/common/AsyncRequestHandler';
import RuleConfigError from 'src/common/RuleConfigError';
import { ServerlessResponse } from 'src/common/ServerlessResponse';
import { RulesDataSourceService } from 'src/service/RulesDataSourceService';
import { RuleGroupAuthenticationValidator } from 'src/validators/RuleGroupAuthenticationValidator';
import { inject, injectable } from 'tsyringe';
 
 
/**
 * @api {get} /rulegroups/{id}/rules/{ruleId} Get a rule
 * @apiGroup Rule
 * @apiDescription Get a rule in a rule group referencing a cloud resource or fixed resource
 * @apiVersion 1.0.0
 * @apiExample {curl} CURL Example:
 curl --location --request GET 'https://<rest_api_id>.execute-api.ap-southeast-2.amazonaws.com/prod/rulegroups/demo-group-group/rules/rule_id'
* @apiSuccess (Success 201) Rule created
* @apiError (Error 400) BadRequest Rule group id path parameter cannot be null or empty
* @apiError (Error 400) BadRequest Rule group id path parameter does not match request body groupId
* @apiError (Error 400) BadRequest RuleGroup  does not exists
* @apiError (Error 403) Forbidden Requestor's arn is not authorized to perform this action
* @apiError (Error 500) RemoteError Error while creating rule object
* 
* @apiSuccessExample Success-Response: 
*      HTTP/1.1 200 OK
*  {
    "rule": {
        "protocol": "tcp",
        "action": "drop",
        "source": "Ec2_Arn_DEMO",
        "destination": "Onprem_Server",
        "status": "PENDING",
        "ruleGroupId": "ruleGroup_Id",
        "lastUpdated": "2021-09-16T23:11:56.198Z",
        "id": "rule_id",
        "destinationPort": {
            "type": "SinglePort",
            "value": '123'
            },
        "sourcePort": {
            "type": "Any"
        },
        "version": 0
    }
}
* 
* @apiSampleRequest off
*/
@injectable()
export class GetRuleHandler
    implements AsyncRequestHandler<APIGatewayProxyEvent, ServerlessResponse> {
    private readonly logger: Logger;
 
    constructor(@inject('LoggerFactory') loggerFactory: LoggerFactory,
        @inject('RulesDataSourceService') private rulesDataSourceService: RulesDataSourceService,
        @inject('RuleGroupAuthenticationValidator') private ruleGroupAuthenticationValidator: RuleGroupAuthenticationValidator
    ) {
        this.logger = loggerFactory.getLogger('GetRuleHandler');
    }
 
    async handle(
        event: APIGatewayProxyEvent,
        // eslint-disable-next-line @typescript-eslint/no-unused-vars
        _context: Context
    ): Promise<ServerlessResponse> {
        this.logger.info('lambda event', event);
        if (!event.pathParameters || !event.pathParameters['id'] || !event.pathParameters['ruleId']) {
            return ServerlessResponse.ofError(
                new RuleConfigError('Parameter rule object id not found', 400, false)
            );
        }
 
        const ruleId = event.pathParameters['ruleId'];
        const ruleGroupId = event.pathParameters['id'];
        const requestorIdentity = event.requestContext.identity?.userArn ?? 'Unkonwn';
        const requestingAccountId = event.requestContext.accountId;
        const errorResposne = await this.ruleGroupAuthenticationValidator.checkRuleGroupAccess(requestorIdentity, ruleGroupId, requestingAccountId, 'GET');
        if (errorResposne) {
            this.logger.error(`Authorization error ${errorResposne.body}`)
            return errorResposne;
        }
 
        const rule = await this.rulesDataSourceService.getRuleBy(ruleId);
        this.logger.info('retrieved rule', rule);
        const matchingRuleGroupId = rule?.ruleGroupId === event.pathParameters['id'];
 
        if (rule && matchingRuleGroupId) {
            return ServerlessResponse.ofObject(200, rule);
        } else {
            const message = rule ? 'Rule not found' : 'Rule group id does not matching the requested rule'
            return ServerlessResponse.ofObject(404, { message });
        }
    }
}