Prerequisites for Wizard-based Deployment on AWS with Kyvos Native

Applies to: Kyvos Enterprise  Kyvos Cloud (SaaS on AWS) Kyvos AWS Marketplace

Kyvos Azure Marketplace   Kyvos GCP Marketplace Kyvos Single Node Installation (Kyvos SNI)

Kyvos provides the following methods for wizard-based deployment on AWS:

• Using Kyvos public AMI

Depending upon your type of installation, you will need to ensure that the corresponding prerequisites are available.

Common prerequisites

Regardless of the type of installation, the following prerequisites should be available.

1. EC2 key pair, consisting of a private key and a public key. You can create the key pair if needed.

Networking requirements

1. Use the Network CloudFormation template to automatically create network resources (VPC, Subnet, and Security Group). 

   1. If you want to deploy your network with NAT Gateway, use the NATGateway Template (vpc_nat.json file in the installation folder).

   2. If you want to deploy your network with Endpoints, use the Endpoints Template ( vpc_internet_gateway.json file in the installation folder).
      OR

   3. If you want to use existing network resources, perform the following steps in your VPC. 

      1. You must create VPC Endpoints within your VPC to connect with the AWS services. Else, you must have the internet and NAT Gateway in the subnet.

         List of VPC Endpoints for AWS services required by Kyvos:

Permission requirements

1. You can create IAM roles using the CloudFormation template (wizard_based_deployment_iam_role.json file).
   OR

2. Create IAM Role for:

   1. Lambda that will be attached to the Kyvos-created Lambda functions. This role contains all the permissions required by lambda functions to run.
      Download the ec2_iam_policy.json and lambda_iam_policy.json files in the installation folder.

3. S3 Bucket permissions for using existing bucket

   If you want to use an existing S3 bucket and IAM role, or if you want to read data from an S3 bucket other than where Kyvos is deployed, then the IAM role must have the following permissions on the S3 bucket.

Here, replace:

• <Bucket Name> with the name of your bucket name.

• <Lambda Role> with the name of your Lambda Role.

• <EC2 Role> with the name of your EC2 Role.

• <kyvosEksOidcrole> Copy the IAM role of Service Account.
  To copy the IAM role of Service Account, perform the following steps.

  1. Login to AWS with your credentials.

  2. Search for EKS.

  3. On the EKS page, click the Add-ons tab.

     Open

     

  4. Navigate to the Mountpoint for Amazon S3v CSI Driver section and copy the ARN role of OIDC.

     Open

     

• <NodeGroupRole> Copy the Node IAM role ARN that will be attached to your Kyvos EKS cluster’s node group.
  To copy the Node IAM role ARN role, perform the following steps.

  1. Login to AWS with your credentials.

  2. Search for EKS.

  3. On the EKS page, click the Compute tab.

  4. Navigate to the Node Groups section and click the group name.

     The Details section is displayed. Copy the Node IAM role ARN.

• Open the deployment bucket permission section and add the ARN of OIDC (see, line number 11) and Node group (see, line number 9) role in the array.

  { "Version": "2008-10-17", "Statement": [ { "Sid": "Ec2LambdaRoleBucketPolicy", "Effect": "Allow", "Principal": { "AWS": [ "arn:aws:iam::815559998352:role/NodeGroupRole-user8s10", "arn:aws:iam::815559998352:role/kyvos-ec2-role-build-automation-iam-roles-2024-3-2", "arn:aws:iam::815559998352:role/kyvosEksOidcrole-userk8s10", "arn:aws:iam::815559998352:role/kyvos-lambda-role-build-automation-iam-roles-2024-3-2" ] }, "Action": [ "s3:PutAnalyticsConfiguration", "s3:GetObjectVersionTagging", "s3:ReplicateObject", "s3:GetObjectAcl", "s3:GetBucketObjectLockConfiguration", "s3:DeleteBucketWebsite", "s3:PutLifecycleConfiguration", "s3:GetObjectVersionAcl", "s3:DeleteObject", "s3:GetBucketPolicyStatus", "s3:GetObjectRetention", "s3:GetBucketWebsite", "s3:PutReplicationConfiguration", "s3:PutObjectLegalHold", "s3:GetObjectLegalHold", "s3:GetBucketNotification", "s3:PutBucketCORS", "s3:GetReplicationConfiguration", "s3:ListMultipartUploadParts", "s3:PutObject", "s3:GetObject", "s3:PutBucketNotification", "s3:PutBucketLogging", "s3:GetAnalyticsConfiguration", "s3:PutBucketObjectLockConfiguration", "s3:GetObjectVersionForReplication", "s3:GetLifecycleConfiguration", "s3:GetInventoryConfiguration", "s3:GetBucketTagging", "s3:PutAccelerateConfiguration", "s3:DeleteObjectVersion", "s3:GetBucketLogging", "s3:ListBucketVersions", "s3:RestoreObject", "s3:ListBucket", "s3:GetAccelerateConfiguration", "s3:GetBucketPolicy", "s3:PutEncryptionConfiguration", "s3:GetEncryptionConfiguration", "s3:GetObjectVersionTorrent", "s3:AbortMultipartUpload", "s3:GetBucketRequestPayment", "s3:GetObjectTagging", "s3:GetMetricsConfiguration", "s3:DeleteBucket", "s3:PutBucketVersioning", "s3:GetBucketPublicAccessBlock", "s3:ListBucketMultipartUploads", "s3:PutMetricsConfiguration", "s3:GetBucketVersioning", "s3:GetBucketAcl", "s3:PutInventoryConfiguration", "s3:GetObjectTorrent", "s3:PutBucketWebsite", "s3:PutBucketRequestPayment", "s3:PutObjectRetention", "s3:GetBucketCORS", "s3:GetBucketLocation", "s3:ReplicateDelete", "s3:GetObjectVersion", "s3:PutBucketTagging" ], "Resource": [ "arn:aws:s3:::kyvos-user8s10-47948/*", "arn:aws:s3:::kyvos-userk8s10-47948" ] } ] }

4. Add below permissions in AWS Wizard based IAM role for listing and describing EKS cluster

   "EKSPolicy": { "Type": "AWS::IAM::Policy", "Condition": "EKSClusterPermissionsInclusion", "Properties": { "PolicyName": "eks-policy", "PolicyDocument": { "Version": "2012-10-17", "Statement": [ { "Sid": "EksDescribeKM", "Effect": "Allow", "Action": [ "eks:ListClusters", "eks:DescribeCluster", "eks:ListNodegroups", "eks:DescribeNodegroup", "eks:DescribeAddon" ], "Resource": "*" }, {

5. You must have the Access Key and Secret Key to access the Kyvos bundle. Contact Kyvos Support for details.

6. Valid Kyvos license file.

7. Create an EKS cluster using CreateEks.json.

8. Run the following commands one by one on every Kyvos node to install kubectl

   curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install --bin-dir /usr/local/bin/ --install-dir /usr/local/aws-cli --update o curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/linux/amd64/kubectl chmod +x ./kubectl sudo chown kyvos:kyvos kubectl sudo mv kubectl /bin/ sudo mkdir -p /home/kyvos/.kube sudo chown -R kyvos:kyvos /home/kyvos/.kube

9. Run the commands below from sudo user on Kyvos Manager node to install eksctl.

10. Once the EKS cluster is created, go to the created node then go to Security.

11. Click the eks-cluster-sg-kyvosEks-{STACK-NAME}-random number as Security group.

12. Add inbound rule to the above security group with TCP 6903 and source group will be the Security Group attached to the BI server.

13. Add inbound rule to the Web server security group with TCP 2181 and source group will be the Security Group which was mentioned above (eks-cluster-sg-kyvosEks-{STACK-NAME}-random number).

14. Add inbound rule to the BI Server security group with TCP 2181 and source group will be the Security Group which was mentioned above (eks-cluster-sg-kyvosEks-{STACK-NAME}-random number).

15. Add inbound rule to the BI Server security group with TCP 45460 and source group will be the Security Group which was mentioned above (eks-cluster-sg-kyvosEks-{STACK-NAME}-random number).

16. Add inbound rule to the BI Server security group with TCP 6803 and source group will be the Security Group which was mentioned above (eks-cluster-sg-kyvosEks-{STACK-NAME}-random number).

17. Open the deployment bucket permission section and add the ARN of OIDC and Node group role in the array.

18. Ensure that the required ports are available.

19. Ensure that the required OS Commands used by Kyvos Manager are available on all the machines.