다음을 통해 공유

서비스 커넥터를 통해 Azure Functions가 서비스에 연결하는 방법

  • 아티클

Azure Functions는 서비스 커넥터에서 지원하는 컴퓨팅 서비스 중 하나입니다. 클라이언트 SDK를 사용할 수도 있지만 바인딩을 사용하여 Azure Functions를 다른 서비스에 연결하는 것이 좋습니다. 이 문서는 다음 내용에 대한 이해를 돕기 위해 작성되었습니다.

  • 서비스 커넥터와 Functions 바인딩 간의 관계
  • 서비스 커넥터에서 바인딩 또는 SDK를 사용하여 Functions를 다른 Azure 서비스에 연결하는 데 사용하는 프로세스
  • 각 시나리오에서 서비스 커넥터와 사용자가 각각 수행하는 담당 작업

필수 조건

서비스 커넥터 및 Azure Functions 바인딩

Azure Functions의 바인딩

바인딩은 함수 코드에서 클라이언트 SDK를 사용할 필요 없이 서비스에 함수를 연결하는 간단한 방법을 제공하는 것을 목표로 Azure Functions에서 사용하는 개념입니다.

바인딩은 입력, 출력 및 트리거를 지원할 수 있습니다. 바인딩을 사용하면 Functions 호스트가 데이터 액세스를 처리할 수 있도록 서비스에 대한 연결을 구성할 수 있습니다. 자세한 내용은 Azure Functions 트리거 및 바인딩 개념을 참조하세요.

함수 바인딩은 비밀/연결 문자열과 ID 기반 인증 유형을 둘 다 지원합니다.

서비스 커넥터

서비스 커넥터는 개발자가 컴퓨팅 서비스를 대상 지원 서비스에 쉽게 연결할 수 있도록 하는 Azure 서비스입니다. Azure Functions는 서비스 커넥터에서 지원하는 컴퓨팅 서비스 중 하나입니다.

논리적으로 추상화된 개념과 더욱 유사한 함수 바인딩에 비해 서비스 커넥터는 직접 작동할 수 있는 Azure 서비스입니다. 연결의 전체 수명 주기(예: create, delete validate 상태 및 list configurations)를 위한 API를 제공합니다.

또한 서비스 커넥터는 비밀/연결 문자열과 ID 기반 인증 유형도 모두 지원합니다.

Azure Functions 바인딩의 연결

Functions 바인딩에서 connection은 함수 폴더의 바인딩 파일(일반적으로 function.json 파일)에 정의된 속성입니다. 바인딩 런타임에서 대상 서비스에 인증하는 데 사용할 앱 설정 이름 또는 접두사를 정의합니다.

서비스 커넥터의 연결

서비스 커넥터의 connection은 서비스 커넥터에 속하는 특정 Azure 리소스를 나타냅니다.

Azure Functions 바인딩에서 사용하는 connection은 서비스 커넥터에서 사용하는 configuration name에 해당합니다. 구성 이름은 서비스 커넥터가 컴퓨팅 서비스의 구성에 저장하는 앱 설정 키 이름을 나타냅니다.

서비스 커넥터를 사용하여 다른 클라우드 서비스에 Azure Functions 연결

서비스 커넥터는 바인딩 또는 SDK를 사용하여 클라우드 서비스에 Azure Functions를 연결하는 데 필요한 작업을 줄입니다. 사용자가 함수 비즈니스 논리에 집중할 수 있도록 앱 설정, 네트워크, ID 및 권한 할당과 같은 클라우드 리소스 구성을 인수합니다. 다음 섹션에서는 서비스 커넥터가 다양한 연결 메커니즘 및 인증 방법을 사용하여 함수 연결을 간소화하는 방법을 설명합니다.

바인딩

  • 비밀/연결 문자열
시나리오 연산 설명 서비스 커넥터 사용 안 함 서비스 커넥터 사용
로컬 프로젝트 바인딩 추가 대상 서비스 유형 및 바인딩 유형(in/out/trigger)에 따라 함수에 바인딩을 추가합니다. 사용자 사용자
바인딩 사용 local.settings.json에서 인증에 대한 연결 문자열을 설정하고 바인딩에 정의된 변수를 사용하도록 함수 코드를 변경합니다. 사용자 사용자
클라우드 리소스 앱 설정 구성 함수 리소스의 구성에서 연결 문자열을 앱 설정으로 구성합니다. 사용자 서비스 커넥터
네트워크 구성 대상 서비스의 네트워크 구성에서 함수 리소스에서의 액세스를 허용하는지 확인합니다. 사용자 서비스 커넥터
  • ID 기반 인증
시나리오 연산 설명 서비스 커넥터 사용 안 함 서비스 커넥터 사용
로컬 프로젝트 바인딩 추가 대상 서비스 유형 및 바인딩 유형(in/out/trigger)에 따라 함수에 바인딩을 추가합니다. 사용자 사용자
바인딩 사용 local.settings.json에서 인증에 대한 연결 문자열을 설정하고 바인딩에 정의된 변수를 사용하도록 함수 코드를 변경합니다. 사용자 사용자
클라우드 리소스 앱 설정 구성 Azure Function의 ID 설정(예: 서비스 엔드포인트)을 구성합니다. 사용자 서비스 커넥터
네트워크 구성 대상 서비스의 네트워크 구성에서 함수 리소스로에서의 액세스를 허용하는지 확인합니다. 사용자 서비스 커넥터
ID 구성 시스템 ID를 사용하여 인증할 때 시스템 ID가 사용하도록 설정되어 있는지 확인합니다. 사용자 서비스 커넥터
사용 권한 할당 대상 서비스에 액세스할 수 있도록 ID에 필요한 역할을 할당합니다. 사용자 서비스 커넥터

함수 바인딩과 함께 Service Connector를 사용하는 경우 서비스 커넥터에서 구성한 함수의 키 이름에 특히 주의해야 합니다. 바인딩 파일의 connection 속성에 정의된 것과 동일한 키 이름인지 확인합니다. 키 이름이 다른 경우 바인딩 파일의 이름을 변경하거나 서비스 커넥터의 customize keys 기능을 사용하여 서비스 커넥터의 기본 구성 이름을 사용자 지정합니다.

SDK

  • 비밀/연결 문자열
시나리오 연산 설명 서비스 커넥터 사용 안 함 서비스 커넥터 사용
로컬 프로젝트 종속성 추가 대상 서비스 및 런타임에 따라 종속성 패키지를 추가합니다. 사용자 사용자
SDK 클라이언트 시작 local.settings.json에서 인증을 위한 연결 문자열을 입력합니다. 연결 문자열을 사용하여 대상 서비스 SDK를 시작합니다. 사용자 사용자
클라우드 리소스 앱 설정 구성 기능의 구성에서 연결 문자열을 앱 설정으로 구성합니다. 사용자 서비스 커넥터
네트워크 구성 대상 서비스의 네트워크 구성에서 함수 리소스에서의 액세스를 허용하는지 확인합니다. 사용자 서비스 커넥터
  • ID 기반 인증
시나리오 연산 설명 서비스 커넥터 사용 안 함 서비스 커넥터 사용
로컬 프로젝트 종속성 추가 대상 서비스 및 런타임에 따라 종속성 패키지를 추가합니다. 사용자 사용자
SDK 클라이언트 시작 local.settings.json에서 인증을 위한 연결 문자열을 입력합니다. 연결 문자열을 사용하여 대상 서비스 SDK를 시작합니다. 사용자 사용자
클라우드 리소스 앱 설정 구성 기능의 구성에서 연결 문자열을 앱 설정으로 구성합니다. 사용자 서비스 커넥터
네트워크 구성 대상 서비스의 네트워크 구성에서 함수 리소스로에서의 액세스를 허용하는지 확인합니다. 사용자 서비스 커넥터
ID 구성 시스템 ID를 사용하여 인증할 때 시스템 ID가 사용하도록 설정되어 있는지 확인합니다. 사용자 서비스 커넥터
사용 권한 할당 대상 서비스에 액세스할 수 있도록 ID에 필요한 역할을 할당합니다. 사용자 서비스 커넥터

다음 단계

다른 대상 서비스를 통합하는 방법을 알아보고 해당 구성 설정 및 인증 방법에 대해 읽어보세요.

스토리지 BLOB을 통합하는 방법 알아보기