/AWS-IAM-RP-Verifier

Library used for verification of AWS::IAM::Role Policy json files. It can be used to both check the general structure of the file, and look for particular statements present within.

Primary LanguageGo

AWS-IAM-RP-Interaction

Description

This library loads, tests and verifies AWS::IAM::Role Policy json files.

Prerequisites

Go has to be installed first, to install it run:

  • Mac: brew install go
  • Ubuntu: sudo apt install golang-go
  • Arch: sudo pacman -S go

Execution

Launch go run . in project's root.

By default, a built-in testcase is used.

You can test your own JSON file by providing it via the -f parameter:

  • run: go run main.go -f tests/data/invalid_wrong_format.json

Testing

Launch go test in project's root, this will run both the standard and the fuzzing (edge-case) tests.

To run individual fuzzing tests, launch go test -fuzz Main.

Task Reference

AWS::IAM::Role Policy: Amazon AWS IAM Documentation

Task description Google documents

Key notes

File structure

This codebase follows project structure recommendations described in the https://go.dev/ documentation.

Tests

Tests have no dedicated folder for the tests themselves besides the data folder. This is the standard recommended by go's documentation.

This ensures high code coverage as there is a clear association being made between the tests and the code they're testing.