# fess-ds-sharepointプラグインを利用したクロール時のroleフィールドについて

**URL:** <https://discuss.codelibs.org/t/fess-ds-sharepoint-role/2191>\
**Category:** Japanese:Fess\
**Created:** [July 6, 2023, 5:57am UTC](https://discuss.codelibs.org/t/fess-ds-sharepoint-role/2191 "2023-07-06T05:57:36Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![watanuki-sohei](https://discuss.codelibs.org/user_avatar/discuss.codelibs.org/watanuki-sohei/32/580_2.png) [@watanuki-sohei](https://discuss.codelibs.org/u/watanuki-sohei)\
**Post date:** [July 6, 2023, 5:57am UTC](https://discuss.codelibs.org/t/fess-ds-sharepoint-role/2191/1 "2023-07-06T05:57:36Z")

</div>

ご多用のところ恐れ入ります。下記の通り質問させてください。  
※不足情報ある場合は大変お手数ですがコメントいただければ幸いです。

■前提

- Fess 14.8.0
- fess-ds-sharepointプラグイン 14.8.0
- ElasticSearch 8.6.2
- [こちら]([簡単導入! OSS全文検索サーバFess入門(35) SharePoint Serverのクロール | TECH+（テックプラス） (mynavi.jp)](https://news.mynavi.jp/techplus/article/techp5457/))を参考にしてクロール設定などは登録した
- クロール先のSharePoint ドキュメントについて
  - 「TEST」フォルダを１つ作成
    - 「TEST」フォルダに対しては「test」Sharepointグループがアクセス許可レベル、フルコントロールで付与されており、配下のドキュメントにはデフォルトで「test」のアクセス許可が付与される。

  - 「TEST」フォルダの中に、Aドキュメント、Bドキュメント、Cドキュメントの3件作成
    - Aドキュメントに対し、「アクセス許可の管理」によるアクセス権は変更しない
      - フォルダのデフォルトの権限、ここでは「test」グループの権限のみが付与されている

    - Bドキュメントに対し、「アクセス許可の管理」により、「test」グループに所属していない、「b」ユーザーのアクセス権限を付与する。
      - フォルダのデフォルトの権限「test」グループについては付与されてる状態のまま変更しない。

    - Cドキュメントに対し、「アクセス許可の管理」により、「test」グループに所属していない、「c」ユーザーのアクセス権限を付与する。
      - フォルダのデフォルトの権限「test」グループについては付与されてる状態のまま変更しない。

■質問内容  
前提のもとクロールし、fess.xxxx（日付）インデックスから結果を確認すると、roleフィールドの値が下記のように期待するroleの値と、実際の値に差異がありました。「アクセス許可の管理」を編集していないドキュメントのroleフィールドには、サイトへのアクセス許可レベルが「制限付きアクセス」のユーザー情報（ここでは「b」と「c」）であっても、サイト内に何かしら紐付くアクセス権は全てroleに登録されているように見えます。  
こちらは仕様でしょうか？また、設定などで期待する値にすることは可能でしょうか？

- 期待するrole
  - Aドキュメント：「test」グループ
  - Bドキュメント：「test」グループ、「b」ユーザー
  - Cドキュメント：「test」グループ、「c」ユーザー

- 実際のrole
  - Aドキュメント：「test」グループ、「b」ユーザー、「c」ユーザー
  - Bドキュメント：「test」グループ、「b」ユーザー
  - Cドキュメント：「test」グループ、「c」ユーザー

■補足情報

- ShrePoint側の設定で回避できたり、APIの仕様である場合は申し訳ありません。
- 実際には、“1system”,“Rguest”,といった値もroleに登録されていますが、本件には関係ないと思うため省略
- 上記の結果がえられた後に、Aドキュメントに対し、SharePoint上で「b」ユーザーのアクセス権を付与し、すぐ「b」ユーザーのアクセス許可を無効にする。その後クロールすると、期待するroleになります。
  - このことから何かしらアクセス許可の編集が行われているドキュメントと、そうでないデフォルトのままのドキュメントをどこかで判断しているのだと想像しますが、それがfess-ds-sharepointの仕様か、使用しているAPI側の仕様かわからずうかがっています。

---

<div class="post-metadata">

**Author:** ![shinsuke](https://discuss.codelibs.org/user_avatar/discuss.codelibs.org/shinsuke/32/6_2.png) [@shinsuke](https://discuss.codelibs.org/u/shinsuke)\
**Post date:** [July 6, 2023, 6:18am UTC](https://discuss.codelibs.org/t/fess-ds-sharepoint-role/2191/2 "2023-07-06T06:18:17Z")

</div>

実装的には[ここらへん](https://github.com/codelibs/fess-ds-sharepoint/blob/fess-ds-sharepoint-14.9.0/src/main/java/org/codelibs/fess/ds/sharepoint/crawl/SharePointCrawl.java#L46-L72)の話かなと思います。

---

<div class="post-metadata">

**Author:** ![watanuki-sohei](https://discuss.codelibs.org/user_avatar/discuss.codelibs.org/watanuki-sohei/32/580_2.png) [@watanuki-sohei](https://discuss.codelibs.org/u/watanuki-sohei)\
**Post date:** [August 3, 2023, 12:52am UTC](https://discuss.codelibs.org/t/fess-ds-sharepoint-role/2191/3 "2023-08-03T00:52:08Z")

</div>

ご回答ありがとうございます。  
頂いた情報を元に、Sharepointの仕様なども含めて調査を行いました。  
時間がかかり返信遅れ申し訳ありませんでした。  
調査内容が今後のバージョンアップの一助になればと思い共有させていただきます。

# 調査結果

## SharePoint Online

- SharePoint Online上のドキュメントに個別でアクセス許可を追加すると、親Webサイトにゲストロール(＝制限付きアクセス)権限が追加されてしまう。
  - 下記の公式リファレンスに「アイテムに対するユーザーアクセス許可を付与すると、最初の一意の先祖Webサイトまで、すべての親フォルダー、リスト、Webサイトに対するゲストロールもユーザーに付与されます」と書かれている。
    - [SharePoint での権限、ユーザー、グループ、およびオブジェクト モデル | Microsoft Learn](https://learn.microsoft.com/ja-jp/sharepoint/dev/general-development/authorization-users-groups-and-the-object-model-in-sharepoint#folder-and-item-extensions)

- 「ゲストロール(=制限付きアクセス)」については、下記の通り「詳細に設定された権限と組み合わせて使用して、サイト全体へのユーザーのアクセスを許可せずに、そのユーザーが特定のリスト、ドキュメントライブラリ、フォルダー、リストアイテム、またはドキュメントにアクセスできるようにする」ために便宜的に設定されるロールで、「制限付きアクセス」の権限が設定されているドキュメント自体にはアクセス権限はない。
  - [オンプレミスの SharePoint Server ユーザーのアクセス許可とアクセス許可レベル - SharePoint Server | Microsoft Learn](https://learn.microsoft.com/ja-jp/sharepoint/sites/user-permissions-and-permission-levels#default-permission-levels)

- 新規作成したドキュメント（「アクセス許可の管理」を一度もしていないドキュメント）は、親要素の権限を継承する。
- あるドキュメントに個別で特定のユーザー／グループの権限を付与すると、そのユーザー／グループに対する「制限付きアクセス」の権限がサイト全体やそれを継承したドキュメントにも付与されるが、実際にアクセスできるのは個別で権限を追加したドキュメントのみ

## fess-ds-sharepointプラグイン

- [GetListItemRole.javaのbuildRoleAssignmentsUrl](https://github.com/codelibs/fess-ds-sharepoint/blob/fess-ds-sharepoint-14.9.0/src/main/java/org/codelibs/fess/ds/sharepoint/client/api/list/getlistitem/GetListItemRole.java#L137)にて権限情報取得時に、アクセス許可の管理をしていない（権限がデフォルト状態の）ドキュメントには「アクセス許可レベル」が「制限付きアクセス」のデータも含まれるため、それも一緒に取得される。

## 結論

- 前述の内容より、当初確認させていただいた『「アクセス許可の管理」を編集していないドキュメントのroleフィールドには、サイトへのアクセス許可レベルが「制限付きアクセス」のユーザー情報（ここでは「b」と「c」）であっても、サイト内に何かしら紐付くアクセス権は全てroleに登録されているように見える』という事象が発生したと思われます

# 追加調査

- SharePoint Onlineのブラウザ上で一度もアクセス許可の管理をしていないドキュメントはデフォルトの権限セット（RoleDefinitionBindings）が付与される。

- [GetListItemRole.javaのbuildRoleAssignmentsUrl](https://github.com/codelibs/fess-ds-sharepoint/blob/fess-ds-sharepoint-14.9.0/src/main/java/org/codelibs/fess/ds/sharepoint/client/api/list/getlistitem/GetListItemRole.java#L137)を、[このあたり](https://github.com/codelibs/fess-ds-sharepoint/blob/fess-ds-sharepoint-14.9.0/src/main/java/org/codelibs/fess/ds/sharepoint/client/api/list/getlistitem/GetListItemRole.java#L78)で実行する際に、APIのURLに`?$expand=RoleDefinitionBindings`を付与すると。RoleTypeKind(アクセス許可レベル)も一緒に取得することができるので、それが期待しない値(0や1など値の詳細は公式の[こちら](https://learn.microsoft.com/ja-jp/dotnet/api/microsoft.sharepoint.client.roletype?view=sharepoint-csom))の場合は、除外するようにすれば以降の処理で、期待する権限をRoleフィールドに追加することができそうだと思いました。

- 補足：
