개요
ICAP profile은 ICAP 서버의 파일 처리 방식을 사용자 지정하고 CDR를 관리하는 수단을 제공합니다. 여러 ICAP profile의 동시 활성화가 지원되지만, 각 수신 respmod 또는 reqmod 요청에는 정확히 하나의 profile만 할당됩니다.
profile
상태
status 속성은 ICAP 서버가 지정된 profile을 계속 사용해야 하는지를 결정합니다. false로 설정하면 profile이 비활성화되고 요청은 오류 메시지와 함께 실패합니다.
profile 설정
콘텐츠 관리 policy
ProfileSettings.ContentManagementPolicy 속성은 Halo 내의 이름이 지정된 policy를 나타냅니다. 이 policy는 RESPMOD 및 REQMOD 요청 내의 모든 콘텐츠에 적용됩니다.
처리 중 지정된 ContentManagementPolicy가 존재하지 않으면 요청은 default profile을 사용하도록 대체됩니다.
'Default'로 표시된 콘텐츠 관리 policy는 default profile에 할당됩니다.
Policy Management에 대해 자세히 알아보기
Processingrulesdefault
ProfileSettings.ProcessingRulesDefault는 ICAP 서버가 인식되지 않은 mime/content-type을 만났을 때 어떤 작업을 수행해야 하는지 결정합니다. 인식되지 않은 콘텐츠 유형은 ProcessingRules 컬렉션에 포함되지 않은 유형을 의미합니다.
Processingrules
ProfileSettings.ProcessingRules는 RESPMODOrREQMOD 요청에 적용할 규칙의 컬렉션입니다. 이 규칙에는 사용자 지정 mime/content-types가 포함될 수 있습니다.
ICAP 서버가 REQMODOrRESPMOD 요청의 content-type과 일치하면, 규칙 값에 따라 콘텐츠를 어떻게 처리할지 결정합니다:
| 규칙 | 설명 |
|---|---|
process | 파일에 CDR를 적용하고 http 콘텐츠를 재구성된 파일로 대체합니다. |
bypass | 아무 작업도 하지 않고 원본 파일을 그대로 통과시킵니다. |
block | 파일에 CDR를 적용하지 않습니다. http 콘텐츠를 오류 보고서로 대체합니다. |
기본 profile
Halo에 ICAP를 설치하면, 첫 시작 시 기본 ICAP profile이 생성되어 유지됩니다. 이 profile은 기본적으로 지원되는 모든 content type을 process로 설정하고, 인식되지 않는 content type은 block으로 설정합니다.
릴리스 2.5.4부터 profile을 재설정하면 새 미디어 유형이 포함되도록 보장됩니다. 2.5.4
예시 profile JSON
{
"ProfileIdentity": "f49f7748-4f33-4638-8f24-bfd721bcd487",
"ProfileName": "default",
"ProfileVersion": 1,
"IsDefaultProfile": true,
"Status": "enabled",
"ProfileSettings": {
"ContentManagementPolicy": "default",
"ProcessingRulesDefault": "block",
"ProcessingRules": {
"application/msword": "process",
"application/vnd.openxmlformats-officedocument.wordprocessingml.document": "process",
"application/vnd.ms-excel": "process",
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": "process",
"application/vnd.ms-powerpoint": "process",
"application/vnd.openxmlformats-officedocument.presentationml.presentation": "process",
"application/pdf": "process",
"image/jpeg": "process",
"image/png": "process",
"image/gif": "process",
"image/tiff": "process",
"image/bmp": "process",
"image/svg+xml": "process",
"image/webp": "process",
"application/x-emf": "process",
"application/x-wmf": "process",
"audio/wav": "process",
"audio/mpeg": "process",
"audio/mp4": "process",
"application/x-bzip2": "process",
"application/gzip ": "process",
"application/x-rar-compressed": "process",
"application/x-tar": "process",
"application/x-xz": "process",
"application/zip ": "process",
"application/x-7z-compressed": "process"
}
}
}
폴백 모드
profile을 검색하고 캐시하는 동안 어떤 이유로든 policy API에 연결할 수 없는 경우, 서비스는 복구할 수 있을 때까지 폴백 profile을 사용할 수 있습니다.
이 profile은 기본 설치된 profile과 동일하게 구성되며, 따라서 기본 콘텐츠 관리 policy 및 처리 규칙을 사용합니다.
이를 활성화하려면 구성 변경을 참조하세요.
비활성화되면 서비스는 다시 시작하여 복구를 시도합니다.