문서 메뉴

문서 홈Atlas App Services

Third-Party Services [Deprecated]

이 페이지의 내용

  • 서론
  • 개념
  • 서비스 클라이언트 [사용 중단됨]
  • 서비스 조치 [사용 중단됨]
  • 서비스 규칙 [사용 중단됨]
  • 수신 Webhooks [사용 중단됨]
  • 가이드
  • 내장 서비스
  • 참조 문서

중요

타사 서비스 & 푸시 알림 사용 중단

App Services의 타사 서비스 및 푸시 알림은 함수에서 외부 종속성을 사용하는 HTTP 엔드포인트를 만들기 위해 더 이상 사용되지 않습니다.

웹훅은 동작에 대한 변경 없이 HTTPS 엔드포인트로 이름이 변경되었습니다. 기존 웹훅을 마이그레이션해야 합니다.

기존 서비스는 2024년 11월 1일까지 계속 운영됩니다.

타사 서비스 및 푸시 알림은 이제 더 이상 사용되지 않으므로 App Services UI에서 기본적으로 제거되었습니다. 기존 타사 서비스 또는 푸시 알림을 관리해야 하는 경우 다음을 수행하여 구성을 UI에 다시 추가할 수 있습니다.

  • 왼쪽 탐색의 Manage 섹션에서 App Settings를 클릭합니다.

  • Temporarily Re-Enable 3rd Party Services 옆의 토글 스위치를 활성화한 다음 변경 사항을 저장합니다.

최신 애플리케이션은 메시징, 분석, 데이터 관리 등의 복잡한 사용 사례를 처리하기 위해 여러 외부 서비스를 사용하는 경우가 많습니다. 서비스 인터페이스를 만들고 구성하여 Atlas App Services를 통해 이러한 서비스에 연결할 수 있습니다.

서비스 인터페이스는 특정 외부 서비스에 대한 연결 세부 정보를 지정하고 사용자 지정 서비스 규칙 을 사용하여 해당 서비스 기능의 범위를 정의할 수 있도록 합니다. 서비스에 대한 인터페이스를 구성한 후에는 인터페이스에 연결하고 서비스의 조치 를 메서드로 노출하는 서비스 클라이언트 를 인스턴스화할 수 있습니다. 외부 서비스가 HTTP를 통해 앱과 직접 통신할 수 있도록 수신 웹훅 을 생성할 수도 있습니다.

참고

내장 서비스 클라이언트

App Services에는 TwilioAmazon Web Services 와 같은 특정 외부 서비스를 위한 클라이언트가 포함됩니다. 또한 HTTP Service 를 사용하여 REST API를 제공하는 모든 외부 서비스에 대한 사용자 지정 인터페이스를 생성할 수도 있습니다.

서비스 클라이언트는 서비스 인터페이스에 연결하고 서비스와 관련된 작업 을 호출할 수 있도록 하는 객체입니다. 함수 컨텍스트( 함수 컨텍스트 사용)와 클라이언트 애플리케이션 코드에서 서비스 클라이언트를 인스턴스화할 수 있습니다.

서비스 클라이언트 인스턴스화 및 사용에 대한 자세한 내용 은 서비스 작업 호출을 참조하세요.

서비스 조치는 Twilio 로 문자 메시지를 보내 거나 객체를 Amazon Web Services S3 버킷에 넣기 와 같이 특정 서비스의 특정 사용 사례를 처리하는 메서드입니다. 조치는 각 서비스에 특정한 시맨틱 메서드 이면의 요청 인증 및 HTTP 메서드와 같은 구현 세부 정보를 캡슐화합니다.

서비스 작업을 호출하면 App Services는 작업에 적용되는 각 서비스 규칙 을 평가하고 규칙 중 하나가 true 로 평가되지 않는 한 실행을 방지합니다.

중요

App Services는 기본적으로 모든 서비스 작업을 차단합니다. 특정 작업을 호출하려면 먼저 특정 작업을 활성화 하는 서비스 규칙을 구성 해야 합니다.

서비스 규칙은 App Services가 사용자가 서비스에서 하나 이상의 작업 을 실행할 수 있는지 여부를 결정하기 위해 평가하는 표현식 입니다.

예를 들어, 사용자가 특정 전화번호로만 문자 메시지를 보낼 수 있도록 하는 Twilio 규칙이나, 승인된 버킷 목록에 포함되지 않은 S3 버킷에 객체를 넣지 못하게 하는 Amazon Web Services 규칙을 만들 수 있습니다.

참고

표현식 변수

표현식 변수 는 애플리케이션 및 작업 실행에 대한 동적 정보를 나타내기 위해 서비스 규칙에 포함할 수 있는 변수입니다. 조치를 호출한 인증된 사용자(%%user)와 사용자가 제공한 인수(%%args)를 기반으로 서비스 규칙을 구성할 수 있습니다. 함수(%function )를 호출하고 함수의 반환 값을 기반으로 평가하는 복잡한 규칙을 만들 수도 있습니다.

수신 웹훅은 누군가가 GitHub 에서 새 pull 요청을 열거나 Twilio 전화번호로 문자 메시지를 보내는 경우와 같이 외부 서비스에서 발생하는 이벤트에 대한 사용자 지정 핸들러입니다. 서비스 웹훅을 구성하여 수신 웹훅을 시작하세요.

수신 웹훅은 웹훅 URL과 웹훅 함수라는 두 가지 주요 구성 요소로 구성됩니다.

구성 요소
설명
Webhook URL

수신 웹훅을 고유하게 식별하는 URL입니다. 외부 서비스는 웹훅의 구성과 일치하는 HTTP 요청을 웹훅 URL에 전송하여 웹훅과 상호 작용할 수 있습니다.

웹훅을 사용하려면 발신 웹훅, 콜백 URL 등이라고도 하는 외부 서비스의 HTTP 요청 핸들러에 웹훅 URL을 제공합니다.

참고

들어오는 웹훅에 비밀 쿼리 매개변수 가 필요한 경우, 외부 서비스에 제공하기 전에 웹훅 URL에 쿼리 매개변수를 추가해야 합니다.

Webhook Function
웹훅 함수는 외부 서비스의 데이터를 인수로 하여 수신되는 HTTP 요청을 수락하고 선택적으로 HTTP 응답을 반환하는 Realm 함수 입니다.
가이드
설명
새로운 외부 서비스 인터페이스를 만드는 방법을 알아보세요.
외부 서비스의 이벤트를 처리하기 위해 수신 웹훅을 구성하고 실행하는 방법을 알아보세요.
함수 또는 클라이언트 애플리케이션에서 사용할 서비스 작업을 안전하게 노출하는 방법을 알아보세요.
함수 또는 클라이언트 애플리케이션에서 서비스 조치를 호출하는 방법을 알아보세요.
주제
설명
서비스 구성 매개변수, Twilio에 웹훅을 추가하기 위한 지침, Twilio 서비스 조치에 대한 추가 정보가 포함되어 있습니다.
HTTP 서비스 작업 및 웹훅에 대한 추가 정보를 포함합니다.
서비스 구성 매개변수, 특정 Amazon Web Services 조치에 대한 추가 정보, Amazon Web Services 서비스에 연결하기 위한 일반적인 지침이 포함됩니다.
서비스 구성 매개변수, GitHub에 웹훅을 추가하기 위한 지침, GitHub에서 들어오는 요청의 유효성을 검사하는 방법에 대한 지침이 포함되어 있습니다.
주제
설명
서비스 웹훅 기능에서 수신 요청을 확인하고, 요청 페이로드를 구문 분석하고, 응답을 보내는 방법을 설명합니다.
← 푸시 알림 [사용 중단됨]