Microsoft 보안 부조종사(미리 보기)
보안 및 IT의 일상적인 작업을 위한 생성 AI 지원 도우미입니다. AI 생성 콘텐츠는 올바르지 않을 수 있습니다. 정확도를 확인합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | 스탠다드 | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 파워 오토메이트 | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL | https://learn.microsoft.com/en-us/connectors/securitycopilot/ |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://learn.microsoft.com/en-us/connectors/securitycopilot/ |
| 개인 정보 취급 방침 | https://learn.microsoft.com/en-us/copilot/security/privacy-data-security |
| 카테고리 | Security |
| 연락처 | securitycopilot@microsoft.com |
Microsoft 보안 코파일럿
필수 구성 요소
이 새 Logic App 커넥터를 최대한 활용하려면 몇 가지 필수 구성 요소를 알아야 합니다.
테넌트 배포 요구 사항: 보안 Copilot 조기 액세스 프로그램에 적극적으로 참여하는 테넌트 내에 논리 앱을 배포해야 합니다.
사용자 인증 및 역할 액세스: Logic App 커넥터를 사용하여 인증하려는 사용자는 특정 액세스 역할을 보유해야 합니다. 이러한 역할과 이러한 역할이 보안 부조종사 프레임워크 내에서 작동하는 방식을 더 깊이 이해하려면 Microsoft 보안 부조종사에서 인증 이해 탐색하는 것이 좋습니다 . | Microsoft Learn
향상된 보안 상호 작용을 위한 데이터 액세스: 인증된 사용자가 다양한 원격 보안 제품의 데이터에 액세스할 수 있도록 하는 것이 중요합니다. 여기에는 Defender 인시던트 보고서를 읽고 MFA(다단계 인증) 세부 정보 수집 등의 작업이 포함됩니다.
Microsoft Security Copilot 조기 액세스 프로그램에 대한 액세스는 다음 온보딩 설명서를 참조하세요.
Authentication
Microsoft Security Copilot 커넥터는 보안 코필로트를 호출하는 데 필요한 권한이 있는 AAD(Entra) 사용자 ID를 대신하여 작동할 수 있습니다.
사용 가능한 리소스
보안 부조종사 커넥터
Azure 논리 앱
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| Oauth | Microsoft Entra ID 자격 증명 제공 | 모든 지역 | 공유할 수 없음 |
| 서비스 주체 인증 | 서비스 주체 인증에 고유한 Microsoft Entra ID 앱을 사용합니다. | 오직 | 공유할 수 없음 |
| 기본값 [사용되지 않음] | 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. | 모든 지역 | 공유할 수 없음 |
Oauth
인증 ID: Oauth
적용 가능: 모든 지역
Microsoft Entra ID 자격 증명 제공
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
서비스 주체 인증
인증 ID: OauthServicePrincipal
적용 가능:
서비스 주체 인증에 고유한 Microsoft Entra ID 앱을 사용합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 클라이언트 ID | 문자열 | 진실 | |
| 클라이언트 암호 | 시큐어스트링 (보안 문자열) | 진실 | |
| 임차인 | 문자열 | 진실 |
기본값 [사용되지 않음]
적용 가능: 모든 지역
이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 600 | 60초 |
actions
| promptbookprompt 평가 상태 가져오기 |
promptbookprompt 평가 상태 가져오기 |
| Security Copilot 에이전트 실행 |
Security Copilot 이전에 구성된 에이전트를 트리거하여 일정에 따라 보안 작업을 자동화합니다. AI 생성 콘텐츠는 올바르지 않을 수 있습니다. 정확도를 확인합니다. |
| 보안 Copilot 프롬프트 제출(V2)(미리 보기) |
보안 질문 또는 태스크를 제출하여 Security Copilot 향상된 에이전트 기술 실행을 사용하여 응답을 받습니다. AI에서 생성된 콘텐츠에는 실수가 포함될 수 있습니다. 응답에서 정확도를 확인합니다. |
| 보안 코필로트 프롬프트 제출 |
보안 질문 또는 작업을 보안 부조종사에 제출하고 응답을 받습니다. AI에서 생성된 콘텐츠에는 실수가 포함될 수 있습니다. 응답에서 정확도를 확인합니다. |
| 프롬프트 상태 가져오기 |
평가 상태 가져오기 |
promptbookprompt 평가 상태 가져오기
promptbookprompt 평가 상태 가져오기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
세션 ID
|
sessionId | True | string |
평가가 수행된 세션의 ID |
|
프롬프트 ID
|
promptId | True | string |
평가된 프롬프트의 ID |
반품
Promptbook 실행 결과 개체
Security Copilot 에이전트 실행
Security Copilot 이전에 구성된 에이전트를 트리거하여 일정에 따라 보안 작업을 자동화합니다. AI 생성 콘텐츠는 올바르지 않을 수 있습니다. 정확도를 확인합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
에이전트 이름
|
agentId | True | string |
실행할 에이전트 선택 |
|
트리거 이름
|
triggerName | True | string |
실행할 트리거 선택 |
|
에이전트 입력을 json 페이로드로 지정합니다.
|
agentInputs | dynamic |
에이전트 실행에 대한 입력 |
반품
보안 Copilot 프롬프트 제출(V2)(미리 보기)
보안 질문 또는 태스크를 제출하여 Security Copilot 향상된 에이전트 기술 실행을 사용하여 응답을 받습니다. AI에서 생성된 콘텐츠에는 실수가 포함될 수 있습니다. 응답에서 정확도를 확인합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
프롬프트 콘텐츠
|
PromptContent | True | string |
보안 부조종사로 평가하라는 메시지 |
|
세션 아이디
|
SessionId | string |
기존 코필로트 세션의 ID입니다. |
|
|
플러그 인
|
Skillsets | array of string |
이 Copilot 세션에 사용할 플러그 인 |
|
|
직접 기술 이름
|
SkillName | string |
호출할 기술 |
|
|
직접 기술 입력
|
SkillInputs | object |
기술 필수 입력 |
반품
평가 결과 개체
보안 코필로트 프롬프트 제출
보안 질문 또는 작업을 보안 부조종사에 제출하고 응답을 받습니다. AI에서 생성된 콘텐츠에는 실수가 포함될 수 있습니다. 응답에서 정확도를 확인합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
프롬프트 콘텐츠
|
PromptContent | True | string |
보안 부조종사로 평가하라는 메시지 |
|
세션 아이디
|
SessionId | string |
기존 코필로트 세션의 ID입니다. |
|
|
플러그 인
|
Skillsets | array of string |
이 Copilot 세션에 사용할 플러그 인 |
|
|
직접 기술 이름
|
SkillName | string |
호출할 기술 |
|
|
직접 기술 입력
|
SkillInputs | object |
기술 필수 입력 |
반품
평가 결과 개체
프롬프트 상태 가져오기
평가 상태 가져오기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
평가 ID
|
evaluationId | True | string |
인출되는 평가 ID |
|
세션 ID
|
sessionId | True | string |
평가가 수행된 세션의 ID |
|
프롬프트 ID
|
promptId | True | string |
평가된 프롬프트의 ID |
반품
평가 결과 개체
정의
EvaluationResult
평가 결과 개체
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
세션 ID
|
sessionId | string | |
|
promptId
|
promptId | string | |
|
evaluationId
|
evaluationId | string | |
|
skillName
|
skillName | string | |
|
promptContent
|
promptContent | string | |
|
evaluationState
|
evaluationState | string | |
|
evaluationResultType
|
evaluationResultType | string | |
|
EvaluationResultContent
|
EvaluationResultContent | string | |
|
nextPromptSuggestions
|
nextPromptSuggestions | array of string |
PromptbookPromptEvaluationResult
Promptbook 프롬프트 평가 결과 개체
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
skillName
|
skillName | string | |
|
promptContent
|
promptContent | string | |
|
evaluationResultType
|
evaluationResultType | string | |
|
EvaluationResultContent
|
EvaluationResultContent | string |
PromptbookRunResult
Promptbook 실행 결과 개체
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
세션 ID
|
sessionId | string | |
|
promptbookState
|
promptbookState | string | |
|
evaluationResults
|
evaluationResults | array of PromptbookPromptEvaluationResult |
ExecutionDetail
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
상태
|
status | ExecutionStatus | |
|
numRuns
|
numRuns | integer | |
|
runIds
|
runIds | array of uuid | |
|
fetchSkillInputs
|
fetchSkillInputs | object | |
|
processSkillInputs
|
processSkillInputs | object | |
|
실행 ID
|
executionId | uuid | |
|
신원 ID
|
identityId | uuid | |
|
세션 ID
|
sessionId | string | |
|
promptId
|
promptId | string | |
|
evaluationId
|
evaluationId | string | |
|
fetchSkillsetName
|
fetchSkillsetName | string | |
|
fetchSkillName
|
fetchSkillName | string | |
|
processSkillsetName
|
processSkillsetName | string | |
|
processSkillName
|
processSkillName | string | |
|
startTime
|
startTime | date-time | |
|
엔드 타임
|
endTime | date-time | |
|
실행 유형
|
executionType | ExecutionType | |
|
error
|
error | ErrorDetailResponse |
ExecutionStatus
ExecutionType
ErrorDetailResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
코드
|
code | string | |
|
message
|
message | string | |
|
target
|
target | string | |
|
details
|
details | array of ErrorDetailResponse | |
|
innerError
|
innerError | MedeinaInnerError |
MedeinaInnerError
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
코드
|
code | string | |
|
innererror
|
innererror | MedeinaInnerError | |
|
사용자 메시지
|
userMessage | string | |
|
evaluationId
|
evaluationId | string | |
|
promptId
|
promptId | string | |
|
세션 ID
|
sessionId | string | |
|
다시 시도 가능
|
retryable | boolean |