AWS Signature Version 4 authentication

출처: 문서

본문

AWS Signature Version 4 인증

aws_sigv4 프로토콜을 사용하는 커넥터는 각 요청을 AWS Signature Version 4로 서명해요. Amazon SageMaker, Amazon Bedrock, Amazon Comprehend, Amazon Textract 같은 AWS 서비스들이 이 프로토콜을 사용해요. 이 프로토콜은 여러분이 제공한 자격 증명으로 각 요청에 서명하고 필요한 Authorization 헤더를 알아서 추가해 주기 때문에, 직접 지정할 필요가 없어요.

다음 요청은 aws_sigv4 프로토콜을 사용하는 독립형 커넥터를 생성하는 예시예요. 프로토콜이 요구하는 credential과 parameters 필드를 보여 주고 있어요. url과 request_body 필드는 호출하려는 서비스와 모델에 따라 달라져요:

POST /_plugins/_ml/connectors/_create
{
    "name": "sagemaker: embedding",
    "description": "Connector for a SageMaker embedding model",
    "version": 1,
    "protocol": "aws_sigv4",
    "credential": {
        "access_key": "<access_key>",
        "secret_key": "<secret_key>",
        "session_token": "<session_token>"
    },
    "parameters": {
        "region": "us-west-2",
        "service_name": "sagemaker"
    },
    "actions": [
        {
            "action_type": "predict",
            "method": "POST",
            "headers": {
                "content-type": "application/json"
            },
            "url": "https://runtime.sagemaker.${parameters.region}.amazonaws.com/endpoints/<endpoint_name>/invocations",
            "request_body": "[\"${parameters.inputs}\"]"
        }
    ]
}

{% include copy-curl.html %}

url, request_body, 그리고 처리 함수까지 포함한 서비스와 모델의 전체 요청이 필요하다면, OpenSearch 제공 커넥터 블루프린트에서 여러분의 플랫폼과 모델에 맞는 블루프린트를 확인해 보세요.

요청 본문 필드

protocol이 aws_sigv4로 설정되면 credential 객체는 다음 필드를 지원해요.

protocol이 aws_sigv4로 설정되면 parameters 객체는 다음 필드를 지원해요.

다음 단계

• 서비스와 모델의 블루프린트를 찾으려면 OpenSearch 제공 커넥터 블루프린트를 참고하세요.
• 이 커넥터를 사용하는 모델을 등록하고 배포하려면 외부 호스팅 모델 연결하기를 참고하세요.

더 알아보기 (Learn more)

• 원문 전체: https://docs.opensearch.org/latest/ml-commons-plugin/remote-models/aws-sigv4/