History

Alex Vanin b19b9977d4 Add a note on s3 gateway running setting		2024-07-16 21:05:25 +03:00
..
data	Initial commit	2024-07-16 20:59:02 +03:00
.gitignore	Add gitignore	2024-07-16 20:59:02 +03:00
check-aws.sh	Initial commit	2024-07-16 20:59:02 +03:00
check-ffs.sh	Initial commit	2024-07-16 20:59:02 +03:00
env.example	Initial commit	2024-07-16 20:59:02 +03:00
prepare-aws.sh	Initial commit	2024-07-16 20:59:02 +03:00
prepare-ffs.sh	Initial commit	2024-07-16 20:59:02 +03:00
README.md	Add a note on s3 gateway running setting	2024-07-16 21:05:25 +03:00

Access control checker

This repo contains prepare-* and check-* scripts to verify migration of eACL policies.

prepare-* scripts must be invoked before update to create some buckets and containers with variety of policies.

check-* scripts must be invoked after update to verify that expected access control behavior is intact.

*-aws scripts invoke AWS CLI to check S3 gateway behaviour.

*-ffs scripts invoke FrostFS CLI to check storage behaviour.

Prerequisites

Make sure you have aws and frostfs-cli commands available.

Make sure S3 gateway is running with kludge.acl_enabled: true setting to create buckets with extended ACLs.

To run these scripts create env file cp env.example env

Path for a file with the size of a simple object.

FILE=./data/cat.jpg

Path for a file with the size of a complex object that should be split during put operation.

COMPLEXFILE=./data/70m

S3 Gateway endpoint.

S3ENDPOINT=http://localhost:8084

Profile name with AWS credentials for content owner

$ aws configure --profile main

S3PROF=main

Profile name with AWS credentials for other user without specific permissions.

$ aws configure --profile ext

S3PROFEXT=ext

Bucket prefix for all created containers. Modify between consecutive runs.

S3PREFIX=av01

Object name stored in buckets.

S3KEY=some/object

Path to FrostFS CLI config file with content owner credentials

FFSCONF=./data/ffs-cli.yaml

Path to FrostFS CLI config file with other user without specific permissions.

FFSCONFEXT=./data/ffs-cli-ext.yaml

Policy for FrostFS containers

PLACEMENT="REP 1"

Path to file with state between prepare-ffs.sh and chech-ffs.sh runs.

CHECKFILE=checkfile.txt

After configuring env file, run prepare-* scripts in any order. Make sure to save logs as they can be useful for debugging.

$ ./prepare-aws.sh | tee prepare-aws.log
$ ./prepare-ffs.sh | tee prepare-aws.log

Then run check scripts after update.

$ ./check-ffs.sh | tee check-ffs.log
$ ./check-aws.sh | tee check-aws.log

In case of any failures, scripts return non-zero exit code.