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 (액세스 기반 열거)입니다. 사용자는 DFS 링크의 하위 집합만 받을 수도 있고, ABE가 호스팅된 홈 디렉터리를 격리할 때 하나의 링크만 받을 수도 있습니다. 커넥터가 DFS 시스템을 탐색할 때 커넥터는 DFS 링크 ACL과 대상의 공유 ACL을 따르며 공유 ACL은 DFS ACL에서 상속됩니다.
알려진 제한사항
- 파일 시스템: 파일 시스템 커넥터는 매핑된 드라이브 및 로컬 드라이브를 지원하지 않습니다.
- 분산 파일 시스템: UNC DFS에 매핑된 드라이브가 올바르게 작동하지 않습니다. 일부 ACL을 올바르게 읽을 수 없습니다.
- 파일 시스템 커넥터는 분산 파일 시스템 (DFS) 네임스페이스 및 링크를 지원합니다. 하지만 커넥터는 DFS 네임스페이스의 일반 폴더가 아닌 DFS 네임스페이스에서만 DFS 링크를 지원합니다.
- cloudsearch.google.com에서 반환된 파일 링크는 클릭할 수 없습니다. Query API에서 반환하는 파일 링크는 대부분의 브라우저에서 클릭할 수 없습니다.
시스템 요구사항
시스템 요구사항 | |
---|---|
운영체제 |
|
소프트웨어 |
|
파일 시스템 프로토콜 |
지원되지 않음: 로컬 Windows 파일 시스템, Sun Network File System (NFS) 2.0, Sun Network File System (NFS) 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
인 Latin-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)을 Indexing API로 전송할 때 액세스 제어 무결성을 유지합니다. 하지만 일부 구성에서는 커넥터에 공유 ACL을 읽을 수 있는 권한이 없을 수 있습니다. 이러한 경우 커넥터는 검색 결과에서 해당 파일 공유에서 유지 관리되는 파일을 반환하지 않습니다.
콘텐츠가 항상 검색 결과에 반환되도록 공유 ACL을 무시하도록 커넥터를 설정할 수 있습니다. 이 경우 Indexing API는 실제 공유 ACL이 아닌 완전히 허용된 공유 ACL을 가져옵니다.
설정 | 매개변수 |
파일 공유 액세스 제어 건너뛰기 | fs.skipShareAccessControl=boolean
공유 ACL을 적용하려면 |