Amazon Rekognition Video 및 Amazon Kinesis 리소스 설정

포커스 모드

Amazon Rekognition Video 및 Amazon Kinesis 리소스 설정 - Amazon Rekognition

사전 조건 카메라 방향 및 설정 레이블 감지 스트림 프로세서에 액세스 권한 부여 AWS CLI 레이블 감지 IAM 역할을 설정하는 명령

다음 절차는 스트리밍 비디오에서 레이블을 감지하는 데 사용되는 Kinesis 비디오 스트림 및 기타 리소스를 프로비저닝하기 위해 수행할 단계를 설명합니다.

사전 조건

이 절차를 실행하려면 AWS SDK for Java 를 설치해야 합니다. 자세한 내용은 Amazon Rekognition 시작 단원을 참조하십시오. 사용할 AWS 계정은 Amazon Rekognition API에 대한 액세스 권한을 가지고 있어야 합니다. 자세한 내용은 IAM 사용 설명서의 Amazon Rekognition에서 정의한 작업을 참조하세요.

비디오 스트림에서 레이블을 감지하려면(AWS SDK)

Amazon S3 버킷을 생성합니다. 사용하려는 버킷 이름과 키 접두사를 모두 기록해 둡니다. 나중에 이 정보가 필요합니다.
Amazon SNS 주제를 생성합니다. 이를 사용하여 관심 객체가 비디오 스트림에서 처음 감지될 때 알림을 수신할 수 있습니다. 해당 주제에 대한 Amazon 리소스 이름(ARN)을 기록해 두세요. 자세한 정보는 Amazon SNS 개발자 안내서의 Amazon SNS 주제 생성을 참조하세요.
해당 Amazon SNS 주제의 엔드포인트를 구독합니다. 자세한 내용은 Amazon SNS 개발자 가이드의 Amazon SNS 주제 구독을 참조하세요.
Kinesis 비디오 스트림을 생성하고 스트림의 Amazon 리소스 이름(ARN)을 적어둡니다.
아직 생성하지 않았다면, Amazon Rekognition Video에 Kinesis 비디오 스트림, S3 버킷 및 Amazon SNS 주제에 대한 액세스 권한을 부여하는 IAM 서비스 역할을 생성하세요. 자세한 내용은 레이블 감지 스트림 프로세서에 액세스 권한 부여 단원을 참조하십시오.

그 후 레이블 감지 스트림 프로세서를 생성하고 선택한 스트림 프로세서 이름을 사용하여 스트림 프로세서를 시작할 수 있습니다.

참고

반드시 미디어를 Kinesis 비디오 스트림으로 수집할 수 있는지 확인한 후에 스트림 프로세서를 시작하세요.

카메라 방향 및 설정

Amazon Rekognition Video 스트리밍 비디오 이벤트는 Kinesis Video Streams에서 지원하는 모든 카메라를 지원할 수 있습니다. 최상의 결과를 얻으려면 카메라를 지면에서 0도에서 45도 사이에 두는 것이 좋습니다. 카메라는 표준 수직 위치에 있어야 합니다. 예를 들어 프레임 안에 사람이 있는 경우 사람은 수직으로 방향을 잡아야 하고 사람의 머리는 프레임에서 발보다 높아야 합니다.

레이블 감지 스트림 프로세서에 액세스 권한 부여

AWS Identity and Access Management (IAM) 서비스 역할을 사용하여 Amazon Rekognition Video에 Kinesis 비디오 스트림에 대한 읽기 액세스 권한을 부여합니다. 그러려면 IAM 역할을 사용하여 Amazon Rekognition Video에 Amazon S3 버킷 및 Amazon SNS 주제에 대한 액세스 권한을 부여하세요.

Amazon Rekognition Video에서 기존 Amazon SNS 주제, Amazon S3 버킷 및 Kinesis 비디오 스트림에 액세스할 수 있도록 허용하는 권한 정책을 생성할 수 있습니다. 를 사용하는 step-by-step 절차는 섹션을 AWS CLI참조하세요AWS CLI 레이블 감지 IAM 역할을 설정하는 명령.

Amazon Rekognition Video에 레이블 감지를 위한 리소스에 대한 액세스 권한을 부여하려면

IAM JSON 정책 편집기로 새 권한 정책을 생성하고 다음 정책을 사용합니다. topicarn을 Kinesis 비디오 스트림의 이름으로, kvs-stream-name을 사용하려는 Amazon SNS 주제의 Amazon 리소스 이름(ARN)으로, bucket-name을 Amazon S3 버킷의 이름으로 바꾸세요.



{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "KinesisVideoPermissions",
            "Effect": "Allow",
            "Action": [
                "kinesisvideo:GetDataEndpoint",
                "kinesisvideo:GetMedia"
            ],
            "Resource": [
                "arn:aws:kinesisvideo:::stream/kvs-stream-name/*"
            ]
        },
        {
            "Sid": "SNSPermissions",
            "Effect": "Allow",
            "Action": [
                "sns:Publish"
            ],
            "Resource": [
                "arn:aws:sns:::sns-topic-name"
            ]
        },
        {
            "Sid": "S3Permissions",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject"
            ],
            "Resource": [
                "arn:aws:s3:::bucket-name/*"
            ]
        }
    ]
}

IAM 서비스 역할을 생성하거나 기존 IAM 서비스 역할을 업데이트합니다. 다음 정보를 사용하여 IAM 서비스 역할을 생성하세요.
1. 서비스 이름으로 Rekognition을 선택합니다.
2. 서비스 역할 사용 사례로 [Rekognition]을 선택합니다.
3. 1단계에 만든 권한 정책을 연결합니다.
서비스 역할의 ARN을 기록합니다. 비디오 분석 작업을 수행하기 전에 스트림 프로세서를 생성해야 합니다.

(선택 사항) 자체 AWS KMS 키를 사용하여 S3 버킷으로 전송된 데이터를 암호화하는 경우 IAM 역할에 다음 문을 추가해야 합니다. (이는 사용하려는 고객 관리형 키에 대응하는 키 정책에 대해 생성한 IAM 역할입니다.)


    
            {
                       "Sid": "Allow use of the key by label detection Role",
                       "Effect": "Allow",
                       "Principal": {
                           "AWS": "arn:aws:iam:::role/REPLACE_WITH_LABEL_DETECTION_ROLE_CREATED"
                       },
                       "Action": [
                           "kms:Decrypt",
                           "kms:GenerateDataKey*"
                       ],
                       "Resource": "*"
            }

AWS CLI 레이블 감지 IAM 역할을 설정하는 명령

아직 하지 않았다면 자격 증명 AWS CLI 으로를 설정하고 구성합니다.

에 다음 명령을 입력하여 레이블 감지에 필요한 권한을 가진 IAM 역할을 AWS CLI 설정합니다.

export IAM_ROLE_NAME=labels-test-role
export AWS_REGION=us-east-1

다음 내용이 포함된 신뢰 관계 정책 파일(예: assume-role-rekognition.json)을 생성합니다.



{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "",
      "Effect": "Allow",
      "Principal": {
        "Service": "rekognition.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

aws iam create-role --role-name $IAM_ROLE_NAME --assume-role-policy-document file://path-to-assume-role-rekognition.json --region $AWS_REGION
aws iam attach-role-policy --role-name $IAM_ROLE_NAME --policy-arn "arn:aws:iam::aws:policy/service-role/AmazonRekognitionServiceRole" --region $AWS_REGION
알림을 수신하고자 하는 SNS 주제의 이름이 “AmazonRekognition” 접두사로 시작하지 않는 경우 다음 정책을 추가하세요.

aws iam attach-role-policy --role-name $IAM_ROLE_NAME --policy-arn "arn:aws:iam::aws:policy/AmazonSNSFullAccess" --region $AWS_REGION
Amazon S3 버킷으로 전송되는 데이터를 암호화하는 데 자체 AWS KMS 키를 사용하는 경우 사용할 고객 관리형 키에 대한 키 정책을 업데이트하세요.
1. 다음 콘텐츠가 포함된 kms_key_policy.json 파일을 생성하세요.
```
{
"Sid": "Allow use of the key by label detection Role",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam:::role/REPLACE_WITH_IAM_ROLE_NAME_CREATED"
},
"Action": [
"kms:Encrypt",
"kms:GenerateDataKey*"
],
"Resource": "*"
} 
                        
```
2. export KMS_KEY_ID=labels-kms-key-id. KMS_KEY_ID를 이전에 만든 KMS 키 ID로 바꾸세요.
3. aws kms put-key-policy --policy-name default --key-id $KMS_KEY_ID --policy file://path-to-kms-key-policy.json