SharePoint Online リンクの取得(制限付きリンク)で URLに付加される文字列

SharePoint Online : 2018.01.31 Wednesday

リンクの取得(制限付きリンク)

SharePoint Onlineドキュメントライブラリ(クラシックUI)で、ファイルを選択して [...]-[...]-[リンクの取得(Copy link)]を順番にクリックすると、ファイルのリンクが取得できます。アクセス権の設定を厳しくしている場合は、「制限付き(アクセス)」のリンクだけが取得できます。アクセス権の設定を緩くしている場合は、「制限付き(アクセス)」「表示」「編集」の3リンクが取得できます。「編集」リンクは ユーザーがこのリンクからSharePoint上のファイルにアクセスすると 固有権限の編集が付与されるという仕組み。「表示」リンクの場合も同様に 閲覧が付与されます。サイト管理者が アクセス権限範囲を特定していても ユーザーが OneDrive for Businessのように 自由に範囲を広げてしまうという「管理者 泣かせ」の機能です。

SharePoint Restricted access link

今回の記事は、制限付き(アクセス)リンクについて。最近、制限付きリンク(URL)の形式が変わりましたね。今までの制限付きリンク(URL)と、最近の制限付きリンク(URL)の書式は 以下の通りです。ドメインとサイトの間に「:(1char):/r/」が入るようになりました。

(従来)
https://TENANT.sharepoint.com/SITE/LIBRARY/FOLDER/FILE?d=(33chars)&csf=1

(最近)
https://TENANT.sharepoint.com/:(1char):/r/SITE/LIBRARY/FOLDER/FILE?d=(33chars)&csf=1



フォルダ、ファイルの種類ごとにURLに付加される1文字が変わる

制限付きリンクのドメインとサイトの間に入る文字「:(1char):/r/」は、フォルダ、ファイルの種類ごとに変わるようです。クラシックUIのドキュメントライブラリで ファイル(またはフォルダ)を選択して [...]-[...]-[リンクの取得(Copy link)]を順番にクリックした場合のリンク(URL)書式は、以下の通りです。

(フォルダ)
https://TENANT.sharepoint.com/:f:/r/SITE/LIBRARY/FOLDER?csf=1

(ファイル Excel)
https://TENANT.sharepoint.com/:x:/r/SITE/LIBRARY/FOLDER/FILE.xlsx?d=(33chars)&csf=1

(ファイル Word)
https://TENANT.sharepoint.com/:w:/r/SITE/LIBRARY/FOLDER/FILE.docx?d=(33chars)&csf=1

(ファイル PowerPoint)
https://TENANT.sharepoint.com/:p:/r/SITE/LIBRARY/FOLDER/FILE.pptx?d=(33chars)&csf=1

(ファイル PDF)
https://TENANT.sharepoint.com/:b:/r/SITE/LIBRARY/FOLDER/FILE.pdf?csf=1

(ファイル JPEG)
https://TENANT.sharepoint.com/:i:/r/SITE/LIBRARY/FOLDER/FILE.jpg?csf=1

(ファイル GIF)
https://TENANT.sharepoint.com/:i:/r/SITE/LIBRARY/FOLDER/FILE.gif?csf=1

(ファイル ZIP)
https://TENANT.sharepoint.com/:u:/r/SITE/LIBRARY/FOLDER/FILE.zip?csf=1


モダンUIのドキュメントライブラリで ファイル(またはフォルダ)を選択して [リンクのコピー(Copy link)]をクリックした場合は、クラシックUIで取得したリンクに eパラメータ 英字 6文字が付加されます。

(フォルダ)
https://TENANT.sharepoint.com/:f:/r/SITE/LIBRARY/FOLDER?csf=1&e=(6chars)

(ファイル Excel)
https://TENANT.sharepoint.com/:x:/r/SITE/LIBRARY/FOLDER/FILE.xlsx?d=(33chars)&csf=1&e=(6chars)

こんなに バラバラのURLパターンがあると、ファイル名を取得するなどのURLを解析するプログラム(PowerShellとか、C#とか)書くのが大変ですね(^−^;正規表現とか 字句解析とか せねば。

URLパラメータ(要素)ごとの意味を考える

制限付きリンクを表す「:(1char):/r/」以外にも、「d=(33chars)」、「csf=1」、「e=(6chars)」の3つが謎な付加パラメータです。

「d=(33chars)」は、ExcelやWordなどのOfficeファイルに付加されるもので、Office Onlineでファイルを開くためのパラメータですね。dパラメータをURLから外すと、Office Onlineではなく クライアントアプリケーションで ファイルを開こうとします。

「csf=1」は、StackExchangeのQ&A でも取り上げられていますが、「Connected Services Framework」の略だとか、諸説あるようですが はっきりしません。このパラメータを外しても 普通にファイル表示できるので あまり重要ではないかも。

「e=(6chars)」は、モダンUIの場合にだけ追加されるパラメータなのですが、このパラメータも謎です。ハッシュ値なのか 暗号化キーなのか 謎な 6英字。このパラメータを外しても 普通にファイル表示できるので あまり重要ではないかも。


【最近の投稿記事】



SharePoint Online
Office 365/SharePoint Online事始め
Office 365やるってよ |  Office 365市販本(できる Office 365) |  Office 365市販本(誰でもできる! Office365導入ガイド) |  MSサイトでプランを勉強 |  TechNetでプランを勉強 |  sway, cortana, delve |  E5プラン |  Office Online制限 |  SharePoint 2016 RC |  アーキテクチャ |  Connections, Listings, Invoicing |  ひと目でわかる SharePoint Server 2016 |  Office 365 ビジネス活用28の事例 | 
SharePoint Online リスト/ライブラリ(クラシック)
標準 リスト/ライブラリ |  アンケート(Survey) |  画像ライブラリ |  ニュースフィード |  日英サイト間でリストデータ移行 |  ライブラリ ドラッグ&ドロップ |  ライブラリ ファイル一覧出力 |  リスト外観変更 |  Explorer URL |  ディスカッション掲示板 |  注目リンク |  OneDrive 通知メール送信 |  OneDrive バージョン履歴 |  アイテムはレコードです |  イベントのエクスポート | 
SharePoint Online Webパーツ(クラシック)
標準 Webパーツ |  スクリプトエディタ |  RSSビューア |  フィルタWebパーツ |  XsltListViewWebPart |  グラフ表示パーツ |  サイトフィード(ニュースフィード)データ出力 | 
SharePoint Online リスト/ライブラリ/ページ(モダン)
ドキュメントライブラリ(Preview) |  複数ファイルダウンロード |  リスト・ライブラリ切替有無 |  ナビゲーション |  サイトのロゴ |  コマンドバー |  リスト ビュー |  リスト フォーム |  サイト情報 |  ホームページ設定 |  列の書式設定(Column Formatting) |  Seattle から Oslo そして Modernへ |  Webパーツページの管理は使えない |  サイドリンクバーの有効化 |  Webブラウザ幅に応じた表示 |  ページ タイトルと画像 |  ページ コピーとメール送信 |  リストビュー Filter |  ページのコメント |  モダンを強制する方法 |  リンクの取得(制限付きリンク) |  発行用ハイパーリンク列はモダンで動かない |  ビュースタイル |  モダン/クラシック混在設計のコツ |  モダン ナビゲーション設計 | 
SharePoint Online Webパーツ/テーマ(モダン)
サイトページ作成とWebパーツ一覧 |  リスト、ライブラリ |  埋め込み |  ファイルビューア― |  リンク |  クイックリンク |  画像ギャラリー |  強調表示されたコンテンツ |  ヒーロー(Hero) |  クイック グラフ (Quick chart) |  テキスト(Text) |  画像 (Image) |  外観の変更 テーマ |  イベント(Events) | 
SharePoint Online 検索機能
検索の対象 |  検索されたくないファイル |  注目サイト |  検索結果カスタマイズ | 
SharePoint Online Notes移行
Notes情報表示 |  Notesデータ移行 | 
SharePoint Online カスタマイズ
IE11開発者ツール |  Osloとの戦い |  Style動的変更 |  リダイレクトページ |  IEとChrome |  ボタン名の変更 |  フロー Flow |  注目リンク カスタマイズ |  アンケート 列設定 変更 |  アンケート Excelエクスポート項目 変更 |  ダウンロード禁止のアクセス許可レベル | 
SharePiont Online 動作仕様
制限値が気になる |  Webページ破損 |  サイトコレクション削除 |  記憶域とサーバーリソース |  プロファイル画像 |  IsDlg効かず |  プレゼンス表示 |  利用状況レポート |  データ容量管理 |  ごみ箱の日数 |  サイトメールボックス |  標準 サイト |  サイドリンクバー |  外部ユーザー共有 |  おすすめ エラー |  直打ちURL |  外観変更エラー |  サイトコレクション機能 |  ユーザープロファイル |  Access app 廃止 |  アクセス要求の設定 |  ページリンク、クラシック表示を終了 |  外部共有サイト、外部ユーザー |  プロジェクトサイトテンプレート ProjectSummaryWebPartエラー |  外部ユーザー削除 Remove-SPOExternalUser |  お知らせタイルとエクスペリエンスバージョン |  クォータ警告と共有設定を一括取得 |  発行インフラストラクチャー機能 Trouble | 
Office 365 動作仕様
OneDrive概要 |  OneDrive設定 |  OWAエラー画面 |  新しい Office 365管理センター |  Office 365メッセージ |  OneNote同期/ファイル |  Office 365サイト |  Office 365監査ログ |  Project Web App |  機能更新とエラー画面 |  Outlook Webのメッセージ | 
search this site.
SharePoint概要
SharePointとは?
アーキテクチャ
サイトテンプレート
リストテンプレート
Webパーツ
アクセス権限
SharePoint用語集


SharePoint構築Tips
リスト名(URL)
ライブラリ名(URL)
フィールド名(内部名)
ビュー名(ファイル名)
リストテンプレート
(ワークフロー削除)

大きなリストの問題
アイテム一覧の列幅
機能とWebパーツ
フィールドデータ型
禁則文字
隠しリスト表示
管理パス
サイト内の列
サポート期限
PDFをブラウザで開く
URLエンコード・デコード
日時の絶対値表示
エクスプローラーで開く
パブリック・個人用ビュー
ひと目でわかるOffice 365ビジネス活用28の事例 SharePoint Server 2016対応版 (マイクロソフト関連書)

SharePoint開発Tips
開発の概要
開発者ダッシュボード
MSDN URL
RESTインターフェイス
ページパラメータ IsDlg
ビジュアルアップグレード
機能(Feature)
2010開発者向けの資格
2013開発者向けの資格
ページパラメータ contents
リソースファイル
リスト/ライブラリGUID
テーマ
トレースログ
PowerShell文字コード
SharePoint Framework
ひと目でわかるOffice 365サイトカスタマイズ&開発編 SharePoint Server 2016対応版

SharePoint情報サイト
SharePoint Developer Center
Support Team Blog
松崎 剛 Blog
SharePoint Developer
SharePoint Technical Note
ILLUMINATE JAPAN Blog
Office365うるのさん奮闘ブログ
AvePoint Japan Community
idea.toString();
SharePoint Issue
Office365/SharePoint
からめもぶろぐ。
Office 365 & PowerX
徒然 Office 365 WebLog
SPeed LAND 365
ひと目でわかる SharePoint Server 2016




   風水吉凶方位 |  奇門遁甲 |  金運神社 |  金運本 |  水族館 |  仏像 |  論語 |  般若心経 |  庭園 |  二十四節気 |  菜根譚 | 
   SharePoint活用 |  OneNote活用 |  サーバー監視 |  イベントログ |  IT資産管理 |  技術TIPS