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やるってよ |  MSサイトでプランを勉強 |  TechNetでプランを勉強 |  E5プラン | 
Office 365/SharePoint Online関連の書籍
できる Office 365 |  誰でもできる! Office365導入ガイド |  ひと目でわかる SharePoint Server 2016 |  Office 365 ビジネス活用28の事例 |  Office 365 サイトカスタマイズ&開発編 |  ひと目でわかる PowerApps |  ひと目でわかる Azure Information Protection | 
Office 365製品、サービス
sway, cortana, delve |  Office Online制限 |  SharePoint 2016 RC |  アーキテクチャ |  Connections, Listings, Invoicing |  Microsoft 365 Roadmap | 
SharePoint Online リスト/ライブラリ(クラシック)
標準 リスト/ライブラリ |  アンケート(Survey) |  画像ライブラリ |  ニュースフィード |  日英サイト間でリストデータ移行 |  ライブラリ ドラッグ&ドロップ |  ライブラリ ファイル一覧出力 |  リスト外観変更 |  Explorer URL |  ディスカッション掲示板 |  注目リンク |  OneDrive 通知メール送信 |  OneDrive バージョン履歴 |  アイテムはレコードです |  イベントのエクスポート |  既定ビュー破損 |  バージョン管理の改悪Update | 
SharePoint Online Webパーツ(クラシック)
標準 Webパーツ |  スクリプトエディタ |  RSSビューア |  フィルタWebパーツ |  XsltListViewWebPart |  グラフ表示パーツ |  サイトフィード(ニュースフィード)データ出力 | 
SharePoint Online リスト/ライブラリ/ページ(モダン)
ドキュメントライブラリ(Preview) |  複数ファイルダウンロード |  リスト・ライブラリ切替有無 |  ナビゲーション |  サイトのロゴ |  コマンドバー |  リスト ビュー |  リスト フォーム |  ホームページ設定 |  列の書式設定(Column Formatting) |  Seattle から Oslo そして Modernへ |  Webパーツページの管理は使えない |  サイドリンクバーの有効化 |  Webブラウザ幅に応じた表示 |  ページ タイトルと画像 |  ページ コピーとメール送信 |  リストビュー Filter |  ページのコメント |  モダンを強制する方法 |  リンクの取得(制限付きリンク) |  発行用ハイパーリンク列はモダンで動かない |  ビュースタイル |  モダン/クラシック混在設計のコツ |  モダン ナビゲーション設計 |  選択肢の追加不可 |  お知らせ表示の方法 |  SharePointページ |  集計値列の日付表示不正 |  いいね! コメント 表示回数 |  ナビゲーションの要素 |  ビューのカラム間隔 |  フォルダ名の禁則文字 |  連絡先,案件管理,DataSheetView形式カスタム |  あとで読むために保存(Save for later) |  UPLOADメッセージ |  ビューの書式設定 |  リストアイテムの印刷 |  2回目のニュース投稿 |  タイトルの領域 | 
SharePoint Online Webパーツ/テーマ(モダン)
サイトページ作成とWebパーツ一覧 |  リスト、ライブラリ |  埋め込み |  ファイルビューア― |  リンク |  クイックリンク |  画像ギャラリー |  強調表示されたコンテンツ |  ヒーロー(Hero) |  クイック グラフ (Quick chart) |  テキスト(Text) |  画像 (Image) |  外観の変更 テーマ |  イベント(Events) |  クイックリンクの順番入替 |  Webパーツが大幅に減少!? |  外観の変更 |  リストWebパーツ不具合 |  クイックリンクのアイコン |  クイックリンクのレイアウト |  画像ギャラリーのレイアウト |  ドキュメントのチェックアウト表示 |  コードスニペット(Code snippet) | 
SharePoint Online サイト(モダン)
サイトメールボックス |  標準 サイト |  サイトコレクション機能 |  サイト情報 |  サイトテンプレートの運用 |  サイトの訪問者 |  サイト情報のサイト削除リンク |  チームサイトテンプレート |  コミュニケーションサイト テンプレート |  ハブサイト |  モダンUIスキャナー |  サイト・リスト構成 | 
SharePoint Online 検索機能
検索の対象 |  検索されたくないファイル |  注目サイト |  検索結果カスタマイズ | 
SharePoint Online 外部共有
外部ユーザー共有 |  外部共有サイト、外部ユーザー |  外部ユーザー削除 Remove-SPOExternalUser |  外部ユーザーの定義とライセンス付与の要否 |  共有の設定オプションが増えた |  サイトコレクション共有設定 | 
SharePoint Online 移行
Notes情報表示 |  Notesデータ移行 |  Sharegateインストール |  Sharegateファイル移行 | 
SharePoint Online カスタマイズ
IE11開発者ツール |  Osloとの戦い |  Style動的変更 |  リダイレクトページ |  IEとChrome |  ボタン名の変更 |  フロー Flow |  注目リンク カスタマイズ |  アンケート 列設定 変更 |  アンケート Excelエクスポート項目 変更 |  ダウンロード禁止のアクセス許可レベル | 
SharePiont PnP PowerShell
PnPの概要 |  テナントバージョン取得 | 
SharePiont Online 動作仕様
制限値が気になる |  記憶域とサーバーリソース |  プロファイル画像 |  IsDlg効かず |  プレゼンス表示 |  利用状況レポート |  データ容量管理 |  ごみ箱の日数 |  サイドリンクバー |  直打ちURL |  ユーザープロファイル |  Access app 廃止 |  アクセス要求の設定 |  ページリンク、クラシック表示を終了 |  お知らせタイルとエクスペリエンスバージョン |  クォータ警告と共有設定を一括取得 |  SharePoint Online 10 GB/User増量 |  SharePoint管理センター |  アクセス要求の設定 |  ファイルアップロードの宛先ライブラリ |  SharePoint管理センター Preview |  データ移行ツール |  サイトページ機能 |  SharePointホームページ |  管理者の業務範囲 |  記憶域の管理 |  クォータの増量要求 | 
SharePiont Online 不具合
Webページ破損 |  サイトコレクション削除 |  おすすめ エラー |  外観変更エラー |  プロジェクトサイトテンプレート ProjectSummaryWebPartエラー |  発行インフラストラクチャー機能 Trouble |  ダウンロード最小化戦略の問題点 |  日時がSeattle時間になる問題 |  サイトコレクション削除後の保存期間 | 
Office 365 動作仕様
OneDrive概要 |  OneDrive設定 |  OWAエラー画面 |  新しい Office 365管理センターUI |  Office 365メッセージ |  OneNote同期/ファイル |  Office 365サイト |  Office 365監査ログ |  Project Web App |  機能更新とエラー画面 |  Outlook Webのメッセージ |  Office 365 ホーム |  OneDrive削除アクティビティメール |  Projectホームページ |  Teamsチームサイトのアクセス権限 |  O365管理センター メニュー |  ASPX,HTMLファイル表示差異 |  Teamsデスクトップクライアント設定 |  Office Online自動保存と自動編集 |  Microsoft Search |  OneDriveページパラメータ |  SharePoint+Teams+O365グループ | 
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情報サイト
Tech community(SharePoint)
SharePoint Developer Center
Support Team 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
Art-Break:Tech
ひと目でわかる SharePoint Server 2016




ひと目でわかるPowerAppsノンコーディングでのビジネスアプリ作成入門 (マイクロソフト関連書)


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