1. OneDrive

OneDrive の設定

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

OneDrive for Business と OneDrive personal で OneDrive 統合を有効にできます。

OneDrive を使用して、次のアクションを実行できます。

  • OneDrive にファイルをチェックアウトする: ファイルが OneDrive にアップロードされ、アセットが Sitecore Content Hub™ でロックされます。

  • OneDrive からファイルをチェックインする: チェックアウトしたファイルが OneDrive から取り込まれ、Content Hub 内のアセットが新しいファイルで更新されます。

  • チェックアウトしたファイルを破棄する: ファイルが OneDrive から削除され、Content Hub 内のアセットがロック解除されます。

  • OneDrive にダウンロードする: ファイルは Content Hub から OneDrive にアップロードされますが、ファイルは追跡されないため、アセットはロック解除されたままになります。

設定

次から選択して、アプリ登録を作成する必要があります。

OneDrive 設定を行う

  • チェックアウト フォルダー (checkoutsFolder) と ダウンロード フォルダー (downloadsFolder): これらのフォルダーは、チェックアウトしたファイルとダウンロードしたファイルを区別するために使用できます。空のままにすると、ファイルはルートのアプリ フォルダーにアップロードされます。

  • logLevel: Content Hub では、アクションごとにジョブが作成されます。loglevel を Error に設定するか、空のままにすると、ジョブ ターゲットは失敗したファイルに対してのみ作成されます。loglevel を Info に設定すると、ジョブ ターゲットはファイルごとに作成されます。

  • enabled: OneDrive 統合を有効にするには、これを true に設定し、無効にするには false に設定する必要があります。

  • clientId と clientSecret: ユーザーがアプリ登録から受け取る個人コード。

  • authorizeUri と tokenUri: OneDrive for Business では、これらをユーザー固有の URI に設定する必要があります。OneDrive personal では、既定値で問題ありません。

{
"basic": {
"apiUri": "https://graph.microsoft.com/",
"apiVersion": "v1.0",
"checkoutsFolder": "Checkouts",
"downloadsFolder": "Downloads",
"logLevel": "Error"
},
"business": {
"enabled": true,
"clientId": "",
"clientSecret": "",
"authorizeUri": "https://login.microsoftonline.com/<customkey>/oauth2/authorize",
"tokenUri": "https://login.microsoftonline.com/<customkey>/oauth2/token"
},
"personal": {
"enabled": true,
"clientId": "",
"clientSecret": "",
"authorizeUri": "https://login.microsoftonline.com/common/oauth2/v2.0/authorize",
"tokenUri": "https://login.microsoftonline.com/common/oauth2/v2.0/token"
}
}
注意

Content Hub のバージョン 3.4.0 では、CloudDrive 統合設定は システム所有で、スーパーユーザーはこれを編集することはできません。バージョン 3.4.1 以降は、この設定はシステム所有ではありません。

OneDrive for Business をセットアップする

次の手順は、OneDrive for Business を統合する方法を示しています。

  • Azure ポータル (https://portal.azure.com) に移動します。

    重要

    Azure Active Directory (Azure AD) は、Microsoft のクラウドベースの ID およびアクセス管理サービスです。従業員はこれを利用してサインインし、リソースにアクセスできます。ただし、Microsoft はこのサービスを 2022 年 6 月までに完全に廃止するとしているため、アプリケーション用に Microsoft Graph API に移行することをお勧めします。

  • 上部の検索バーを使用し、Azure Active Directory を検索して選択します。

  • [Azure Active Directory] ページの [管理] の下で、[アプリの登録] を選択します。

  • [アプリの登録] ページのトップ メニューで、[+ 新規登録] オプションを選択します。

  • [アプリケーションの登録] ページが表示されたら、アプリケーションの登録情報を入力します。

    • 名前: アプリのユーザーに表示するわかりやすいアプリケーション名を入力します。

    • サポートされているアカウント タイプ: アプリケーションでサポートするアカウントを選択します。

      • この組織ディレクトリ内のアカウントのみ: 基幹業務 (LOB) アプリケーションを作成する場合は、このオプションを選択します。
      • 任意の組織ディレクトリ内のアカウント: すべてのビジネスおよび教育機関の顧客をターゲットにする場合は、このオプションを選択します。
      • 組織ディレクトリ内のアカウントと個人の Microsoft アカウント: 最も幅広い顧客を対象にするには、このオプションを選択します。

  • リダイレクト URI (オプション): リダイレクト URI は、OneDrive に正常にログインした後にリダイレクトされる URL です。[Web] または [SPA - シングル ページ アプリケーション] のいずれかを選択します。この例では、[Web] を選択しています。[OneDrive for Business に接続する] を使用してユーザー プロファイルから OneDrive for Business にログインしている場合、リダイレクト URI には、プロファイル名も含める必要があります (例: https://{your_sitecore_content_hub_instance}/en-us/user/myprofile)。

    必要なアドレスを見つけるには、 アイコンをクリックし、メニューの [プロファイル] を選択します。このページは、新しいアプリケーションの登録時、または後で マニフェストの作成時に replyUrlsWithType 属性で使用できる正しいリダイレクト URI です。

    この例では、https://stylelabs.io/en-us/user/myprofile を使用しています。

  • 必要な詳細を入力したら、[登録] をクリックします。

  • Azure AD からアプリに対して一意のアプリケーション (クライアント) ID が割り当てられ、アプリケーションの概要ページが自動的に表示されます。

    アプリケーション (クライアント) ID の値は、Content Hub の OneDrive 統合設定にある clientId フィールドで必須です。

  • [管理] メニューの下の [証明書とシークレット] オプションを選択してクライアント シークレットを生成します。

  • [証明書とシークレット] ページで、[+ 新しいクライアント シークレット] をクリックします。

  • [クライアント シークレットの追加] モーダルで、[説明] テキスト ボックスにクライアント シークレットの説明を入力し、有効期限のオプションから有効期限日を選択します。

    • 1 年
    • 2 年
    • 無期限

    続行するには [追加] をクリックします:

  • アプリケーションの資格情報が更新され、シークレットの値がコピー オプションとともに表示されます。この値は、コピーして別の場所に保存しておく必要があります (後で取得することはできません)。

    クライアント シークレットは、Content Hub の OneDrive 統合設定にある clientSecret フィールドで必須の値です。

  • [管理] の下で、[マニフェスト] オプションを選択します。

    Web ベースのマニフェスト エディターが開き、ポータル内でマニフェストを編集できます。オプションで、[ダウンロード] を選択してマニフェストをローカルで編集し、次に [アップロード] を使用してアプリケーションに再適用できます。

  • アプリケーションの作成時に リダイレクト URI を追加しなかった場合、JSON ファイルで replyUrlsWithType を検索し、https://{your_sitecore_content_hub_instance}/en-us/user/myprofile の値を入力します。

    replyUrlsWithType 属性は、トークンを返すときに Azure AD が出力先として受け入れる、登録済みの redirect_uri 値のリストを保持します。各 URI 値には、関連するアプリ タイプの値を含める必要があります。

    サポートされているタイプの値は次のとおりです。

    • Web
    • InstalledClient

    次の例では、サポートされているタイプの値 Web をタイプの値として選択しています。

        "replyUrlsWithType": [

{
"url": "https://stylelabs.io/en-us/user/myprofile",
"type": "Web"
}
],
    注意

    Azure Active Directory アプリ マニフェストの詳細については、「Azure Active Directory アプリケーション マニフェスト」を参照してください。

  • マニフェストの編集が終了したら、[保存] をクリックします:

  • [マニフェスト] ページのメニューで [概要] オプションを選択して、[概要] ページに戻ります。

  • [概要] ページで、[エンドポイント] オプションを選択します。

  • [エンドポイント] モーダルが開き、テナントの認証エンドポイントが表示されます。使用している認証プロトコルに一致するエンドポイントとアプリケーション (クライアント) ID を組み合わせて、アプリケーションに固有の認証リクエストを作成します。

    OAuth 2.0 認証エンドポイント (v1) と OAuth 2.0 トークン エンドポイント (v1) をコピーします。エンドポイントをクリップボードにコピーするには、各エンドポイントの末尾に表示されている アイコンをクリックします。

  • OAuth 2.0 認証エンドポイント (v1) をクリップボードにコピーします。

    OAuth 2.0 認証エンドポイント (v1) の値は、Content Hub の OneDrive 統合設定の authorizeUri フィールドで必須です。

  • OAuth 2.0 トークン エンドポイント (v1) をクリップボードにコピーします。

    OAuth 2.0 トークン エンドポイント (v1) の値は、Content Hub の OneDrive 統合設定の tokenUri フィールドで必須です。

  • authorizeUri と tokenUri の両方を OAuth 2.0 認証エンド ポイント (v1) と OAuth 2.0 トークンエンドポイント (v1) に入力したら、[保存] をクリックします:

  • アプリ登録の [概要] に戻り、左側のメニューで "API のアクセス許可" をクリックして、新しいアクセス許可を追加します。

  • アクセス許可を追加するには、[+ アクセス許可の追加] をクリックします。

  • [API のアクセス許可の要求] モーダルで、[一般的に使用される Microsoft API] を下にスクロールして [サポートされているレガシー API] の下の [Azure Active Directory Graph] を選択します。

  • [委任されたアクセス許可] を選択します。[委任されたアクセス許可] により、Azure Active Directory のアプリケーションが、特定のユーザーに代わってアクションを実行できるようになります。

  • [委任されたアクセス許可] セクションで、[すべて展開] をクリックしてすべてのアクセス許可を表示します。

  • 使用する Azure Active Directory Graph に必須の委任されたアクセス許可は次のとおりです。

    • Directory.AccessAsUser.All - サインインしたユーザーとしてディレクトリにアクセス: ディレクトリ内の情報に対して、サインインしたユーザーと同じアクセス権をアプリに許可します。

    • User.Read - サインインしてユーザー プロファイルを読み取る: アプリにサインインすることをユーザーに許可し、サインインしたユーザーのプロファイルを読み取ることをアプリに許可します。また、サインインしたユーザーの基本的な会社情報を読み取ることもアプリに許可します。

  • [アクセス許可の追加] をクリックしてアクセス許可を保存すると、[API のアクセス許可] ページに自動的に戻り、現在の保存済みのアクセス許可が表示されます。

  • 次に、SharePoint へのアクセス許可を追加する必要があります。[+ アクセス許可の追加] ボタンをクリックします。

    [Microsoft API] タブで、下にスクロールして [SharePoint] オプションを選択します。

  • [委任されたアクセス許可] オプションを選択します。

    SharePoint へのアクセス許可として要求する必要がある API のアクセス許可は次のとおりです。

    • MyFiles.Read - ユーザー ファイルの読み取り: 現在のユーザーのファイルを読み取ることをアプリに許可します。
    • MyFiles.Write - ユーザー ファイルの読み取りと書き込み: 現在のユーザー ファイルの読み取り、作成、更新、削除をアプリに許可します。
    • Sites.Search.All-ユーザーとして検索クエリを実行する：アプリの実行を許可します検索クエリ現在サインインしているユーザーに代わって基本的なサイト情報を読む。検索結果は、アプリのアクセス許可ではなく、ユーザーのアクセス許可に基づきます。
    • TermStore.ReadWrite.All - 管理されたメタデータの読み取りと書き込み: サインインしているユーザーに代わってアプリが、管理されたメタデータの読み取り、作成、更新、削除を行い、基本的なサイト情報を読み取ることを許可します。

    これらのアクセス許可を選択したら、[アクセス許可の更新] ボタンをクリックします。アクセス許可が追加されます。

    警告

    Sites.Search.All および TermStore.ReadWrite.All には管理者の同意が必要です。

    必要な管理者の同意を得ていない場合、Content Hub に接続すると次のエラーが表示されます。

    したがって、必要な管理者の同意を得ていること、各 API/アクセス許可のステータスが付与済みであることを IT サポートに確認してください。

この記事を改善するための提案がある場合は、 お知らせください!