> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 자금세탁방지(AML)

> AML Watch list filtering 및 Ongoing Monitoring 설정 방법을 안내합니다.

자금세탁방지(AML) 기능은 사용자가 위험인물 명단에 포함되어 있는지 확인하여 금융 범죄를 방지하는 중요한 보안 기능입니다. 이 기능을 통해 실시간으로 위험인물을 식별하고 적절한 조치를 취할 수 있도록 지원합니다.

<Frame caption="자금세탁방지(AML) 설정 페이지">
  <img src="https://mintcdn.com/argosidentity/352WpTnZFyEfW7I6/images/dashboard/new/pj/policy-and-aythentication/aml/page.png?fit=max&auto=format&n=352WpTnZFyEfW7I6&q=85&s=9026b46841e87a0ab644ada795c969c9" alt="AML 설정 페이지" width="2275" height="486" data-path="images/dashboard/new/pj/policy-and-aythentication/aml/page.png" />
</Frame>

***

## AML이 필요한 이유

자금세탁방지(AML, Anti-Money Laundering)는 금융기관과 규제 대상 기업들이 반드시 준수해야 하는 법적 의무사항입니다. AML 기능을 통해 다음과 같은 목적을 달성할 수 있습니다:

### 법규 준수 및 규제 대응

* **금융실명거래법 준수**: 고객의 신원 확인 및 위험인물 검사 의무 이행
* **국제 제재 규정 준수**: UN, OFAC 등 국제 제재 명단에 포함된 인물 식별
* **금융감독원 가이드라인 준수**: 금융기관의 AML/CFT(자금세탁방지 및 테러자금조달방지) 의무 이행

### 리스크 관리 및 손실 방지

* **자금세탁 방지**: 불법 자금의 유입을 사전에 차단하여 기관의 평판 손상 방지
* **제재 위반 방지**: 제재 대상자와의 거래를 사전에 차단하여 법적 책임 회피
* **PEP(정치적 공인) 관리**: 정치적 공인과의 거래 시 강화된 실사(EDD) 수행

### 운영 효율성 향상

* **자동화된 검사**: 수동 검토 작업을 최소화하여 운영 효율성 향상
* **실시간 모니터링**: 지속적인 모니터링을 통해 변화 사항 즉시 감지
* **체계적인 기록 관리**: AML 검사 결과를 체계적으로 관리하여 감사 대응 용이

***

## AML 기능 개요

AML(Anti Money Laundering) 기능은 자금세탁방지 모니터링으로, 제출건 상의 취합된 인물의 **이름, 생년월일, 국적** 등을 바탕으로 실제 유의 또는 위험 인물일 경우를 참고할 수 있습니다.

ARGOS는 두 가지 AML 검사 방식을 제공합니다:

<CardGroup cols={2}>
  <Card title="AML Watch list filtering" icon="magnifying-glass">
    eKYC 완료 시점에 **1회성 검사**를 수행하여 위험인물 명단과 매칭 여부를 확인합니다.
  </Card>

  <Card title="AML Ongoing Monitoring" icon="radar">
    등록된 사용자를 **지속적으로 재점검**하여 제재, PEP, 평판 리스크 등의 변화를 감지합니다.
  </Card>
</CardGroup>

***

## AML Watch list filtering vs AML Ongoing Monitoring

두 방식의 차이점과 각각 어떤 상황에서 사용하는지 비교합니다.

### 비교표

| 구분        | AML Watch list filtering        | AML Ongoing Monitoring          |
| --------- | ------------------------------- | ------------------------------- |
| **검사 시점** | eKYC 완료 시점에 1회 검사               | 등록 후 정기적으로 지속 검사                |
| **검사 대상** | 승인된 제출건 (submission)            | 모니터링 등록된 사용자 (monitor record)   |
| **검사 주기** | 즉시 1회                           | 설정된 주기별 자동 재검사                  |
| **변화 감지** | 검사 시점의 상태만 확인                   | 시간 경과에 따른 변화 감지                 |
| **활용 목적** | 신규 고객 가입 시 위험인물 차단              | 기존 고객의 지속적 모니터링                 |
| **설정 위치** | 프로젝트 관리 > 정책 및 인증 > 자금세탁방지(AML) | 프로젝트 관리 > 정책 및 인증 > 자금세탁방지(AML) |

### 사용 시나리오

<AccordionGroup>
  <Accordion title="AML Watch list filtering 사용 시나리오" icon="user-check">
    **신규 고객 가입 시 즉시 검사**

    * 은행 계좌 개설 시 위험인물 여부 확인
    * 금융 서비스 가입 시 제재 대상자 차단
    * 대량 거래 전 거래 상대방 검증
    * 고액 송금 전 수신인 검사

    **특징:**

    * eKYC 완료와 동시에 자동으로 검사 수행
    * 검사 결과에 따라 즉시 승인/거절 결정 가능
    * 별도의 모니터링 등록 과정 불필요
  </Accordion>

  <Accordion title="AML Ongoing Monitoring 사용 시나리오" icon="clock-rotate-left">
    **기존 고객의 지속적 모니터링**

    * 기존 고객이 제재 명단에 새로 추가된 경우 감지
    * PEP(정치적 공인) 지위 변경 감지
    * 평판 리스크 노출(RRE) 변화 감지
    * 정기적인 고객 재심사(KYC 재검증)

    **특징:**

    * Worklist 단위로 모니터링 정책 관리
    * 주기별 자동 재검사로 변화 사항 즉시 알림
    * 과거 판정 결과와 비교하여 변화 추적
  </Accordion>
</AccordionGroup>

### 선택 가이드

<Tip>
  **언제 어떤 방식을 사용해야 할까요?**

  * **AML Watch list filtering**: 신규 고객 가입 시 즉시 위험인물을 차단하고 싶을 때
  * **AML Ongoing Monitoring**: 기존 고객의 지속적인 모니터링이 필요할 때
  * **둘 다 사용**: 신규 가입 시 검사와 기존 고객 모니터링을 모두 수행하고 싶을 때
</Tip>

***

## AML Watch list filtering

eKYC가 완료된 사용자를 대상으로 AML Watch list filtering을 진행할 수 있습니다.

<Frame caption="AML Watch list filtering 설정 옵션">
  <img src="https://mintcdn.com/argosidentity/O8OeSMtlnaLv75Zo/images/dashboard/new/pj/policy-and-aythentication/aml/search_option.png?fit=max&auto=format&n=O8OeSMtlnaLv75Zo&q=85&s=541fad8a0abc723351bccd2d34686398" alt="AML Watch list filtering 설정" width="2275" height="209" data-path="images/dashboard/new/pj/policy-and-aythentication/aml/search_option.png" />
</Frame>

### 설정 옵션

| 설정                | 설명                                                                                 |
| ----------------- | ---------------------------------------------------------------------------------- |
| **위험도 임계값 설정**    | 위험인물 여부를 판단하는 점수 기준을 직접 설정합니다. 모든 수치는 **낮을수록 검사 기준이 관대**하며, **높을수록 검사 기준이 엄격**합니다. |
| **전체 생년월일 일치 옵션** | 프로필(이름, 국적)과 생년월일이 모두 일치하는 경우에만 검색 결과에 표시됩니다.                                      |

<Info>
  **임계값 설정 가이드**

  * **낮은 임계값 (예: 70-80)**: 더 많은 매칭 결과를 반환하지만 오탐지 가능성 증가
  * **높은 임계값 (예: 90-95)**: 정확도는 높지만 일부 위험인물을 놓칠 수 있음
  * **권장 설정**: 업계 표준은 90-93 범위이며, 내부 정책에 따라 조정 가능
</Info>

<Warning>
  **AML 검사 결과 활용**

  AML 검사 결과는 **참고용**으로 활용하시고, 최종 판단은 관련 법규와 내부 정책에 따라 진행해 주세요. 자동 승인/거절 기능을 사용할 경우 신중하게 임계값을 설정하세요.
</Warning>

### 동작 방식

1. **eKYC 완료**: 사용자가 ID 인증을 완료하고 승인 상태가 됩니다.
2. **자동 검사**: 설정된 임계값과 옵션에 따라 자동으로 AML 검사가 수행됩니다.
3. **결과 확인**: [AML 검색](/dashboard/ko/aml-search) 페이지에서 검사 결과를 확인할 수 있습니다.
4. **조치 결정**: 검사 결과에 따라 승인, 추가 검증, 또는 거절을 결정합니다.

***

## AML Ongoing Monitoring

eKYC가 완료된 사용자를 대상으로 지속 관리 모니터링을 위해 Ongoing Monitoring을 설정할 수 있습니다.

<Frame caption="AML Ongoing Monitoring Worklist 목록">
  <img src="https://mintcdn.com/argosidentity/352WpTnZFyEfW7I6/images/dashboard/new/pj/policy-and-aythentication/aml/ongoing-list.png?fit=max&auto=format&n=352WpTnZFyEfW7I6&q=85&s=a647083bfabd69d2e3f41420d4cc93b9" alt="AML Ongoing Monitoring Worklist" width="2275" height="429" data-path="images/dashboard/new/pj/policy-and-aythentication/aml/ongoing-list.png" />
</Frame>

### 주요 개념

<CardGroup cols={3}>
  <Card title="Worklist" icon="list-ul">
    온고잉 모니터링 정책을 설정하고 모니터링 대상을 등록하는 **작업공간**입니다. 하나의 Project 내에서 여러 개의 Worklist를 관리할 수 있습니다.
  </Card>

  <Card title="Monitor Record" icon="user">
    모니터링 대상으로 등록된 **사용자의 정보**입니다. ARGOS는 해당 Monitor Record를 대상으로 정기적 스크리닝을 수행합니다.
  </Card>

  <Card title="Matches" icon="bullseye">
    모니터링 대상에 대해서 정기적 스크리닝을 수행하여 나타나는 **일치 결과**입니다. 컴플라이언스 운영팀은 해당 Match 결과 리뷰를 통해 AML 업무를 수행합니다.
  </Card>
</CardGroup>

### 동작 방식

1. **Worklist 생성**: 모니터링 정책과 임계값을 설정하여 Worklist를 생성합니다.
2. **모니터링 등록**: eKYC 완료 시 자동 등록 또는 수동으로 모니터링 대상을 등록합니다.
3. **정기적 스크리닝**: 설정된 주기에 따라 자동으로 재검사를 수행합니다.
4. **변화 감지**: 제재 명단, PEP, 평판 리스크 등에 변화가 생기면 Open 매칭으로 알림을 생성합니다.
5. **매치 리뷰**: 관리자가 매칭 결과를 리뷰하여 True Positive 또는 False Positive로 판정합니다.

<Card title="AML 온고잉 모니터링 상세 가이드" icon="radar" href="/dashboard/ko/aml-ongoing-monitoring">
  Worklist 생성, 모니터링 등록, 매치 리뷰 등 상세한 사용 방법을 확인하세요.
</Card>

***

## API 연동 방법

AML 기능을 API를 통해 연동하여 자동화된 워크플로우를 구축할 수 있습니다.

### AML Watch list filtering API

eKYC 완료 후 자동으로 검사되지만, 필요시 수동으로 API를 호출하여 검사를 수행할 수 있습니다.

<Card title="POST/AML API" icon="code" href="/ko/idcheck/api-reference/api-reference-guide/aml_data/aml_search/Post-Aml">
  AML 검사를 수행하는 API 사용 방법을 확인하세요.
</Card>

**API 사용 예시:**

```javascript theme={null}
// AML 검사 수행
const response = await fetch('https://rest-api.argosidentity.com/v3/submission/aml', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    submissionId: 'sub_abc123',
    amlThreshold: 93  // 대시보드에서 설정한 임계값과 동일하게 설정
  })
});

const result = await response.json();
// result.result: "Not Screened", "Match", "No Match" 등
```

### AML Ongoing Monitoring API

Worklist 생성, 모니터링 등록, 매치 조회 등을 API로 수행할 수 있습니다.

<CardGroup cols={2}>
  <Card title="POST/AML Ongoing" icon="plus" href="/ko/idcheck/api-reference/api-reference-guide/aml_data/aml_ongoing/Post_Ongoing_Monitoring">
    모니터링 레코드를 생성합니다.
  </Card>

  <Card title="GET/AML Ongoing" icon="magnifying-glass" href="/ko/idcheck/api-reference/api-reference-guide/aml_data/aml_ongoing/Get_Ongoing_Monitoring">
    모니터링 레코드를 조회합니다.
  </Card>

  <Card title="DELETE/AML Ongoing" icon="trash" href="/ko/idcheck/api-reference/api-reference-guide/aml_data/aml_ongoing/Delete_Ongoing_Monitoring">
    모니터링 레코드를 삭제합니다.
  </Card>
</CardGroup>

**API 사용 예시:**

```javascript theme={null}
// 모니터링 레코드 등록
const response = await fetch('https://rest-api.argosidentity.com/v3/submission/aml/ongoing', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    submissionId: 'sub_abc123',
    recordId: 'user_12345',
    worklistName: 'High-Risk-Monitoring'
  })
});
```

### 웹훅 연동

AML 검사 결과나 Ongoing Monitoring 매칭 결과를 웹훅으로 수신하여 자동화된 처리를 수행할 수 있습니다.

<Card title="웹훅 가이드" icon="webhook" href="/ko/idcheck/webhooks/overview">
  AML 웹훅 이벤트 설정 방법을 확인하세요.
</Card>

**웹훅 이벤트 예시:**

```javascript theme={null}
// AML 검사 완료 웹훅 처리
app.post('/webhooks/idcheck', (req, res) => {
  if (req.body.webhook_trigger === 'aml') {
    const { submissionId, amlStatus, matches } = req.body;
    
    if (amlStatus === 'match') {
      // 위험인물 매칭 시 처리
      flagForReview(submissionId);
      notifyComplianceTeam(submissionId, matches);
    }
  }
  
  res.status(200).send('OK');
});

// Ongoing Monitoring 매칭 웹훅 처리
app.post('/webhooks/idcheck', (req, res) => {
  if (req.body.webhook_trigger === 'aml_monitor') {
    const { recordId, matchType, riskLevel } = req.body;
    
    // 변화 감지 시 처리
    handleOngoingMatch(recordId, matchType, riskLevel);
  }
  
  res.status(200).send('OK');
});
```

***

## 관련 문서 및 연계 방법

AML 기능을 효과적으로 활용하기 위해 관련 문서를 참고하세요.

<CardGroup cols={2}>
  <Card title="AML 검색" icon="magnifying-glass" href="/dashboard/ko/aml-search">
    AML Watch list filtering 결과를 확인하고 관리합니다.
  </Card>

  <Card title="AML 온고잉 모니터링" icon="radar" href="/dashboard/ko/aml-ongoing-monitoring">
    지속적인 AML 모니터링을 설정하고 Worklist를 관리합니다.
  </Card>

  <Card title="AML 코드" icon="list-ol" href="/ko/idcheck/reference_tables/aml-codes">
    AML 검사 결과 코드 목록과 의미를 확인합니다.
  </Card>

  <Card title="POST/AML API" icon="code" href="/ko/idcheck/api-reference/api-reference-guide/aml_data/aml_search/Post-Aml">
    AML 검사를 수행하는 API 사용 방법을 확인합니다.
  </Card>

  <Card title="GET/AML Report API" icon="file-lines" href="/ko/idcheck/api-reference/api-reference-guide/aml_data/aml_search/Get-Aml-Report">
    AML 리포트를 조회하는 API 사용 방법을 확인합니다.
  </Card>

  <Card title="웹훅 가이드" icon="webhook" href="/ko/idcheck/webhooks/overview">
    AML 웹훅 이벤트를 설정하여 자동화된 처리를 구현합니다.
  </Card>
</CardGroup>

***

## 통합 워크플로우 예시

AML 기능을 통합하여 사용하는 워크플로우 예시입니다.

<Steps>
  <Step title="1. AML 설정">
    프로젝트 관리 > 정책 및 인증 > 자금세탁방지(AML)에서 Watch list filtering과 Ongoing Monitoring을 활성화하고 임계값을 설정합니다.
  </Step>

  <Step title="2. eKYC 프로세스">
    사용자가 ID 인증을 완료하면 자동으로 AML Watch list filtering이 수행됩니다.
  </Step>

  <Step title="3. 검사 결과 확인">
    AML 검색 페이지에서 검사 결과를 확인하고, 위험인물이 발견된 경우 추가 검증 또는 거절을 결정합니다.
  </Step>

  <Step title="4. 모니터링 등록">
    승인된 사용자 중 모니터링이 필요한 경우, Ongoing Monitoring에 자동 또는 수동으로 등록합니다.
  </Step>

  <Step title="5. 지속적 모니터링">
    Ongoing Monitoring이 정기적으로 재검사를 수행하고, 변화가 감지되면 웹훅을 통해 알림을 받습니다.
  </Step>

  <Step title="6. 매치 리뷰 및 조치">
    Ongoing Monitoring의 매치 결과를 리뷰하여 적절한 조치를 취합니다.
  </Step>
</Steps>

***

<Tip>
  **최적의 AML 운영을 위한 권장사항**

  1. **Watch list filtering**: 신규 고객 가입 시 필수로 활성화하여 위험인물을 사전에 차단
  2. **Ongoing Monitoring**: 고위험 고객이나 VIP 고객에 대해 지속적 모니터링 설정
  3. **임계값 조정**: 초기에는 보수적인 임계값(높은 값)으로 시작하여 운영 경험을 바탕으로 조정
  4. **웹훅 연동**: 자동화된 알림 및 처리를 위해 웹훅을 적극 활용
  5. **정기적 리뷰**: AML 검사 결과와 매치 리뷰를 정기적으로 검토하여 정책 개선
</Tip>
