Google Workspace 콘텐츠 외에도 조직의 Microsoft Windows 공유에서 검색 결과를 반환하도록 Google Cloud Search를 설정할 수 있습니다. Google Cloud Search 파일 시스템 커넥터를 사용하고 지정된 Windows 공유에 액세스하도록 구성합니다. 단일 커넥터 인스턴스가 여러 Microsoft Windows 공유를 지원할 수 있습니다.
중요 고려사항
연속 자동 업데이트
기본적으로 커넥터는 시작 시 커넥터 구성 파일의 fs.src 값인 시작 경로를 지속적으로 모니터링합니다. 파일 시스템에서 콘텐츠 또는 액세스 제어의 변경사항을 보고하면 커넥터가 트리거되어 파일 시스템을 다시 크롤링합니다. 이 재크롤링은 리소스 집약적일 수 있습니다. 파일 시스템 모니터링을 사용 중지하려면 fs.monitorForUpdates를 false로 설정하세요. 커넥터의 리소스 사용량을 크게 줄이지만 커넥터가 변경사항을 반영하는 시점이 지연됩니다. 자세히 알아보기
DFS 액세스 제어
DFS 시스템은 링크에 액세스 제어를 적용하며 일반적으로 각 DFS 링크에 자체 ACL이 있습니다. DFS에서 사용하는 메커니즘 중 하나는 사용자에게 반환되는 DFS 링크를 제한할 수 있는 액세스 기반 열거 (ABE)입니다. ABE가 호스팅된 홈 디렉터리를 격리하면 사용자에게 DFS 링크의 하위 집합만 표시되거나 링크가 하나만 표시될 수도 있습니다. 커넥터가 DFS 시스템을 통과할 때 커넥터는 DFS 링크 ACL과 대상의 공유 ACL을 따르며 공유 ACL은 DFS ACL에서 상속됩니다.
알려진 제한사항
- 파일 시스템: 파일 시스템 커넥터는 매핑된 드라이브 및 로컬 드라이브를 지원하지 않습니다.
- 분산 파일 시스템: UNC DFS에 매핑된 드라이브가 올바르게 작동하지 않습니다. 일부 ACL을 올바르게 읽을 수 없습니다.
- 파일 시스템 커넥터는 분산 파일 시스템 (DFS) 네임스페이스 및 링크를 지원합니다. 하지만 DFS 네임스페이스의 일반 폴더가 아닌 DFS 네임스페이스의 DFS 링크만 지원합니다.
- cloudsearch.google.com에서 반환된 파일 링크는 클릭할 수 없습니다. Query API에서 반환하는 파일 링크도 대부분의 브라우저에서 클릭할 수 없습니다.
시스템 요구사항
| 시스템 요구사항 | |
|---|---|
| 운영체제 |
|
| 소프트웨어 |
|
| 파일 시스템 프로토콜 |
지원되지 않음: 로컬 Windows 파일 시스템, Sun NFS (Network File System) 2.0, Sun NFS (Network File System) 3.0 또는 로컬 Linux 파일 시스템 |
커넥터 배포
기본 요건
Cloud Search 파일 시스템 커넥터를 배포하기 전에 다음 기본 요건 구성요소가 모두 환경에 있는지 확인하세요.
Google Cloud Search와 데이터 소스 간의 관계를 설정하는 데 필요한 Google Workspace 정보:
- Google Workspace 비공개 키 (서비스 계정 ID 포함) 비공개 키를 가져오는 방법에 대한 자세한 내용은 Google Cloud Search REST API에 대한 액세스 구성을 참고하세요.
- Google Workspace 데이터 소스 ID입니다. 데이터 소스 ID를 가져오는 방법에 대한 자세한 내용은 검색할 데이터 소스 추가하기를 참고하세요.
- ID 소스 ID입니다. ID 소스 ID를 가져오는 방법에 대한 자세한 내용은 ID 소스 만들기를 참고하세요. Google Workspace 디렉터리를 Active Directory와 동기화하는 경우 GCDS로 ID 소스를 설정합니다.
일반적으로 조직의 Google Workspace 관리자가 이러한 사용자 인증 정보를 제공할 수 있습니다.
다음 섹션에 설명된 권한이 Windows 계정에 있는지 확인합니다.
필요한 Microsoft Windows 계정 권한
커넥터가 실행 중인 Microsoft Windows 계정은 아래의 작업에 대한 권한이 있어야 합니다.
- 폴더의 콘텐츠 나열
- 문서의 콘텐츠 읽기
- 파일 및 폴더의 속성 읽기
- 파일 및 폴더의 읽기 권한(ACL)
- 기본 속성 권한 쓰기
다음 그룹에 속한 구성원에게는 Windows 계정에 커넥터에 필요한 충분한 권한이 부여됩니다.
- 관리자
- 고급 사용자
- 인쇄 운영자
- 서버 운영자
1단계: Google Cloud Search 파일 시스템 커넥터 설치
GitHub에서 커넥터 저장소를 가져와 빌드합니다.
Windows 서버에서 git을 사용하려면 다음 단계를 따르세요.
저장소를 복제합니다.
> git clone https://github.com/google-cloudsearch/windows-filesystems-connector.git > cd windows-filesystems-connector
원하는 버전의 커넥터를 체크아웃합니다.
> git checkout tags/v1-0.0.3
GitHub에서 직접 다운로드하려면 다음 단계를 따르세요.
- https://github.com/google-cloudsearch/windows-filesystems-connector로 이동합니다.
- 클론 또는 다운로드 ZIP 다운로드를 클릭합니다.
- 패키지의 압축을 풉니다.
- 새 디렉터리로 이동합니다.
> cd windows-filesystems-connector
커넥터를 빌드합니다. 필요한 경우 Apache Maven을 설치합니다.
> mvn package
커넥터를 빌드할 때 테스트를 건너뛰려면
mvn package대신mvn package -DskipTests를 실행합니다.커넥터 zip 파일을 로컬 설치 디렉터리에 복사합니다.
> cp target/google-cloudsearch-windows-filesystems-connector-v1-0.0.3.zip installation-dir > cd installation-dir > unzip google-cloudsearch-windows-filesystems-connector-v1-0.0.3.zip > cd google-cloudsearch-windows-filesystems-connector-v1-0.0.3
2단계: 커넥터 구성 파일 만들기
커넥터 설치와 동일한 디렉터리에서 파일을 만들고 이름을
connector-config.properties로 지정합니다.다음 예와 같이 파일 콘텐츠에 매개변수를 키-값 쌍으로 추가합니다.
### File system connector configuration ### # Required parameters for Cloud Search data source and identity source access api.serviceAccountPrivateKeyFile=/path/to/file.json api.sourceId=0123456789abcde api.identitySourceId=a1b1c1234567 # Required parameters for file system access fs.src=\\\\host\\share;\\\\dfshost\\dfsnamespace;\\\\dfshost\\dfsnamespace\\link # Optional parameters for file system monitoring traverse.abortAfterExceptions=500 fs.monitorForUpdates = true fs.preserveLastAccessTime = IF_ALLOWED각 매개변수에 대한 자세한 설명은 구성 매개변수 참조를 참고하세요.
(선택사항) 필요에 따라 다른 커넥터 매개변수를 구성합니다. 자세한 내용은 Google 제공 커넥터 매개변수를 참고하세요.
3단계: 로깅 사용 설정
- 커넥터 바이너리가 있는 디렉터리에
logs라는 폴더를 만듭니다. 커넥터 바이너리가 포함된 디렉터리에
logging.properties라는 ASCII 또는 UTF-8 파일을 만들고 다음 콘텐츠를 추가합니다.handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler # Default log level .level = WARNING com.google.enterprise.cloudsearch.level = INFO com.google.enterprise.cloudsearch.fs.level = INFO # uncomment line below to increase logging level to enable API trace #com.google.api.client.http.level = FINE java.util.logging.ConsoleHandler.level = INFO java.util.logging.FileHandler.pattern=logs/connector-fs.%g.log java.util.logging.FileHandler.limit=10485760 java.util.logging.FileHandler.count=10 java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
4단계: (선택사항) 미디어 유형 구성
기본적으로 커넥터는 JDK에서 제공하는 미디어 형식 감지를 사용하여 각 파일의 미디어 형식을 감지하려고 합니다. Microsoft Windows에서 JDK는 Windows 레지스트리를 사용하여 파일의 미디어 유형을 확인합니다. 레지스트리 항목이 누락된 경우 특정 파일의 미디어 형식이 null이 될 수 있습니다.
필요한 경우 기존 바인딩을 덮어쓰거나 null 미디어 유형을 방지하는 미디어 유형을 지정할 수 있습니다.
- 커넥터 디렉터리에서
mime-type.properties라는 라틴어 1로 암호화된 파일을 만듭니다. 다음 예와 같이 파일 확장자와 해당하는 미디어 유형을 입력합니다.
xlsx=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet one=application/msonenote txt=text/plain pdf=application/pdf
5단계: 파일 시스템 커넥터 실행
파일 시스템 커넥터를 설치하고 구성한 후 호스트 머신에서 실행하려면 다음 예와 같은 명령어를 실행합니다.
> java -jar google-cloudsearch-windows-filesystems-connector-v1-0.0.3.jar -Djava.util.logging.config.file=logging.properties[ -Dconfig=my.config]구성 파일 경로가 기본값 (connector-config.properties라는 이름의 바이너리와 동일한 디렉터리)과 다른 경우 지정합니다.
구성 매개변수 참조 정보
데이터 소스 액세스
| 설정 | 매개변수 |
| 데이터 소스 ID | api.sourceId=1234567890abcdef
필수 항목입니다. Google Workspace 관리자가 설정한 Google Cloud Search 소스 ID입니다. |
| 서비스 계정 비공개 키 파일의 경로 | api.serviceAccountPrivateKeyFile=./PrivateKey.json
필수항목. Google Cloud Search 파일 시스템 커넥터 액세스용 Google Cloud Search 서비스 계정 키 파일입니다. |
| ID 소스 ID | api.identitySourceId=x0987654321
필수 항목입니다. Google Workspace 관리자가 GCDS를 사용하여 활성 디렉터리 ID를 동기화하기 위해 설정한 Cloud Search ID 소스 ID입니다. |
파일 시스템 액세스
| 설정 | 매개변수 |
| 소스 파일 시스템 | fs.src=path1[,path2, ...]
필수 항목입니다. 소스 파일 시스템을 |
경로 구분자 문자
| 설정 | 매개변수 |
| 경로 구분자 문자 | fs.src.separator=separator-character
기본 구분자는 ';"입니다. 소스 경로에 세미콜론이 포함된 경우 경로의 문자와 충돌하지 않고 속성 파일 구문 자체에 예약되지 않은 다른 구분 기호(예: 쉼표 (","))를 설정할 수 있습니다.
|
커넥터 동작
| 설정 | 매개변수 |
| Windows 도메인 | fs.supportedDomain=domain
GCDS로 설정된 사용자가 Cloud Search를 통해 문서에 액세스할 수 있도록 하려면 필요합니다. Active Directory의 단일 NetBIOS 도메인 이름으로 지정합니다. |
| ACLS에 계정 포함 | fs.supportedAccounts=account-1[, account-2,...]
기본 제공 계정 여부와 관계없이 ACL에 포함할 계정의 쉼표로 구분된 목록입니다. 기본값은 |
| ACL에서 기본 제공 계정 제외 | fs.builtinGroupPrefix=prefix
기본 제공 계정의 접두사를 지정합니다. 이 접두사로 시작하는 계정은 기본 제공 계정으로 간주되며 ACL에서 제외됩니다. 기본값은 |
| 숨김 파일 및 폴더의 색인 생성 허용 | fs.crawlHiddenFiles=boolean
커넥터가 숨김 파일 및 폴더를 크롤링하도록 허용하려면 |
| 크롤링된 폴더 목록 및 DFS 네임스페이스 열거의 색인 생성 허용 | fs.indexFolders=boolean
|
| 파일 시스템 변경 모니터링 사용 설정 | fs.monitorForUpdates=boolean
|
| 디렉터리 캐시의 최대 크기 설정 | fs.directoryCacheSize=number-of-entries
디렉터리 캐시의 최대 크기입니다. 커넥터는 캐시를 사용하여 숨겨진 폴더를 식별하여 숨겨진 폴더의 파일 및 폴더에 색인을 생성하지 않습니다. 기본값은 50,000개 항목이며, 일반적으로 10~15MB의 RAM을 사용합니다. |
타임스탬프 보존 및 크롤링 제어
| 설정 | 매개변수 |
| 마지막 액세스 타임스탬프 보존 | fs.preserveLastAccessTime=value
커넥터가 파일 및 폴더를 크롤링할 때 커넥터는 파일 및 폴더의 마지막 액세스 타임스탬프를 크롤링 시간으로 변경할 수 있습니다. 마지막 액세스 시간이 보존되지 않으면 커넥터의 방문으로 인해 백업 및 보관처리 시스템이 적절한 파일 및 폴더를 보조 스토리지로 이동하지 않을 수 있습니다. 기본적으로 커넥터는 마지막 액세스 시간을 보존하려고 시도합니다 ( 가능한 값은 다음과 같습니다.
|
| 특정 날짜 이후에 액세스된 파일만 크롤링 | fs.lastAccessedDate=YYYY-MM-DD
마지막 액세스 시간이 지정된 날짜 이후인 경우에만 콘텐츠를 크롤링합니다. 기본값은 날짜를 ISO8601 날짜 형식(YYYY-MM-DD)으로 지정합니다. 예를 들어 값이 2010-01-01이면 커넥터는 2010년 초 이후에 액세스된 콘텐츠만 크롤링합니다.
|
| 지난 기간(일) 이내에 액세스된 파일만 크롤링 | fs.lastAccessedDays=number-of-days
마지막 액세스 시간이 현재로부터 몇 일 이내인 경우에만 콘텐츠를 크롤링합니다. 기본값은 이 속성을 사용하여 한동안 액세스되지 않은 이전에 색인이 생성된 콘텐츠를 만료합니다. 예를 들어 365로 설정하면 전년도에 액세스한 콘텐츠만 크롤링합니다.
|
| 특정 날짜 이후에 수정된 파일만 크롤링 | fs.lastModifiedDate=YYYY-MM-DD
최종 수정 시간이 지정된 날짜 이후인 경우에만 콘텐츠를 크롤링합니다. 기본값은 날짜를 ISO8601 날짜 형식(YYYY-MM-DD)으로 지정합니다. 예를 들어 값이 2010-01-01이면 커넥터는 2010년 초 이후에 수정된 콘텐츠만 크롤링합니다.
|
| 지난 일 수 이내에 수정된 파일만 크롤링 | fs.lastModifiedDays=number-of-days
마지막 수정 시간이 현재로부터 몇 일 이내인 경우에만 콘텐츠를 크롤링합니다. 기본값은 이 속성을 사용하여 한동안 수정되지 않은 이전에 색인이 생성된 콘텐츠를 만료합니다. 예를 들어 365로 설정하면 전년도에 수정된 콘텐츠만 크롤링합니다.
|
파일 공유 액세스 제어 건너뛰기
기본적으로 커넥터는 파일 공유의 ACL을 비롯하여 액세스 제어 목록 (ACL)을 색인 생성 API에 보낼 때 액세스 제어 무결성을 유지합니다. 그러나 일부 구성에서는 커넥터에 공유 ACL을 읽을 권한이 충분하지 않을 수 있습니다. 이 경우 커넥터는 검색 결과에 해당 파일 공유에 유지되는 파일을 반환하지 않습니다.
콘텐츠가 항상 검색 결과에 반환되도록 공유 ACL을 무시하도록 커넥터를 설정할 수 있습니다. 이 경우 indexing API는 실제 공유 ACL이 아닌 완전히 허용된 공유 ACL을 가져옵니다.
| 설정 | 매개변수 |
| 파일 공유 액세스 제어 건너뛰기 | fs.skipShareAccessControl=boolean
공유 ACL을 적용하려면 |