/
設定ガイド for クロスドメイン(CORS)

設定ガイド for クロスドメイン(CORS)

Owned by Hanayo Minamisawa [Ricksoft]
2022/03/26

Alfresco 6.2+, 7.0+

  1. /opt/alfresco/content-services/tomcat/shared/classes/alfresco-global.propertiesを編集します。

    cors.enabled=true
cors.allowSubdomains=true
cors.allowed.origins=https://alfresco.sample.net,https://jira.sample.net
cors.allowed.methods=GET,HEAD,POST,PUT,DELETE,OPTIONS
cors.allowed.headers=Accept,Access-Control-Request-Headers,Access-Control-Request-Method,Authorization,Content-Type,Cache-Control,X-Requested-With,X-CSRF-Token
cors.exposed.headers=Access-Control-Allow-Origin,Access-Control-Allow-Credentials
cors.support.credentials=true
cors.preflight.maxage=10
cors.allowGenericHttpRequests=true
  2. cors.allowed.originsのパラメーターにクロスドメインでのアクセスを許可するURLを指定する。
    (アスタリスクは利用できません。ConfluenceとAlfresco URLの    両方を指定してください)
  3. Restart Alfresco

※CORS設定の詳細は以下のドキュメントをご参考ください。

Alfresco 5.2 - 6.1

  1. /opt/alfresco-content-services/tomcat/webapps/alfresco/WEB-INF/lib と cors-filter-2.5.jar, java-property-utils-1.9.1.jarが配置されていることを確認します。

  2. /opt/alfresco-content-services/tomcat/webapps/alfresco/WEB-INF/web.xmlを編集します。

  3. <!-- CORS Filter Begin -->から<!-- CORS Filter End -->のコメント化されているfilter要素をコメント解除します。

       <!-- CORS Filter Begin -->
   <filter>
      <filter-name>CORS</filter-name>
      <filter-class>com.thetransactioncompany.cors.CORSFilter</filter-class>
      <init-param>
         <param-name>cors.allowGenericHttpRequests</param-name>
         <param-value>true</param-value>
      </init-param>
      <init-param>
         <param-name>cors.allowOrigin</param-name>
         <param-value>http://localhost:8081</param-value>
      </init-param>
      <init-param>
         <param-name>cors.allowSubdomains</param-name>
         <param-value>true</param-value>
      </init-param>
      <init-param>
         <param-name>cors.supportedMethods</param-name>
         <param-value>GET, HEAD, POST, PUT, DELETE, OPTIONS</param-value>
      </init-param>
      <init-param>
         <param-name>cors.supportedHeaders</param-name>     <param-value>origin, authorization, x-file-size, x-file-name, content-type, accept, x-file-type</param-value>
      </init-param>
      <init-param>
         <param-name>cors.supportsCredentials</param-name>
         <param-value>true</param-value>
      </init-param>
      <init-param>
         <param-name>cors.maxAge</param-name>
         <param-value>3600</param-value>
      </init-param>
   </filter>
   <!-- CORS Filter End -->

  4. init-param要素のcors.allowOriginパラメーターで指定されているURLにクロスドメインでのアクセスを許可するURLを指定する。
    (ここではすべてのURLからのアクセスを許可する場合はアスタリスクとしていますが環境に応じて適切なURLを指定してください)

          <init-param>
         <param-name>cors.allowOrigin</param-name>
         <!--param-value>http://localhost:8081</param-value-->
         <param-value>*</param-value>
      </init-param>

  5. <!-- CORS Filter Mappings Begin -->から<!-- CORS Filter Mappings End -->のコメント化されているfilter-mapping要素をコメント解除します。

       <!-- CORS Filter Mappings Begin -->
   <filter-mapping>
      <filter-name>CORS</filter-name>
      <url-pattern>/api/*</url-pattern>
      <url-pattern>/service/*</url-pattern>
      <url-pattern>/s/*</url-pattern>
      <url-pattern>/cmisbrowser/*</url-pattern>
   </filter-mapping>
   <!-- CORS Filter Mappings End -->
  6. Alfrescoを再起動します。

Alfresco 5.0.2 - 5.1

※記載されているバージョンについてはお客様の環境のバージョンへ読み替えてください。

１．/opt/alfresco/tomcat/webapps/alfresco/WEB-INF/lib に cors-filter-1.9.3.jar、java-property-utils-1.9.1.jar が配置されていることを確認します。

２．/opt/alfresco/tomcat/webapps/alfresco/WEB-INF/web.xml を編集します。

<!-- CORS Filter Begin --> から <!-- CORS Filter End --> のコメント化されている filter 要素をコメント解除します。

   <!-- CORS Filter Begin -->
   <filter>
      <filter-name>CORS</filter-name>
      <filter-class>com.thetransactioncompany.cors.CORSFilter</filter-class>
      <init-param>
         <param-name>cors.allowGenericHttpRequests</param-name>
         <param-value>true</param-value>
      </init-param>
      <init-param>
         <param-name>cors.allowOrigin</param-name>
         <param-value>http://localhost:8081</param-value>
      </init-param>
      <init-param>
         <param-name>cors.allowSubdomains</param-name>
         <param-value>true</param-value>
      </init-param>
      <init-param>
         <param-name>cors.supportedMethods</param-name>
         <param-value>GET, HEAD, POST, PUT, DELETE, OPTIONS</param-value>
      </init-param>
      <init-param>
         <param-name>cors.supportedHeaders</param-name>
      </init-param>
      <init-param>
         <param-name>cors.supportsCredentials</param-name>
         <param-value>true</param-value>
      </init-param>
      <init-param>
         <param-name>cors.maxAge</param-name>
         <param-value>3600</param-value>
      </init-param>
   </filter>
   <!-- CORS Filter End -->


４．init-param 要素の cors.allowOrigin パラメーターで指定されている URL にクロスドメインでのアクセスを許可する URL を指定します。
(ここではすべての URL からのアクセスを許可する場合はアスタリスクとしていますが環境に応じて適切な URL を指定してください)

      <init-param>
         <param-name>cors.allowOrigin</param-name>
         <!--param-value>http://localhost:8081</param-value-->
         <param-value>*</param-value>
      </init-param>

５．<!-- CORS Filter Mappings Begin -->から<!-- CORS Filter Mappings End -->のコメント化されている filter-mapping 要素をコメント解除します。

   <!-- CORS Filter Mappings Begin -->
   <filter-mapping>
      <filter-name>CORS</filter-name>
      <url-pattern>/api/*</url-pattern>
      <url-pattern>/service/*</url-pattern>
      <url-pattern>/s/*</url-pattern>
      <url-pattern>/cmisbrowser/*</url-pattern>
   </filter-mapping>
   <!-- CORS Filter Mappings End -->

６．Alfresco を再起動します。

Alfresco 5.0.1

１． cors-filter-2.4.jarとjava-property-utils-1.9.1.jarを /opt/alfresco/tomcat/webapps/alfresco/WEB-INF/lib に配置します。

２．/opt/alfresco/tomcat/webapps/alfresco/WEB-INF/web.xml を下記のように編集します。

<filter>要素のCORSはどこに設定しても問題はありません。
ただし、<filter-mapping> は Global Localization Filter の後、CMIS security context cleaning filte rの前にする必要があるそうです。
   <filter>
      <filter-name>JSF Session Synchronized Filter</filter-name>
      <filter-class>org.alfresco.repo.web.filter.beans.SessionSynchronizedFilter</filter-class>
   </filter>
 
   <!-- ここから追加 -->
   <filter>
      <filter-name>CORS</filter-name>
      <filter-class>com.thetransactioncompany.cors.CORSFilter</filter-class>
      <init-param>
         <param-name>cors.allowOrigin</param-name>
         <param-value>*</param-value>
      </init-param>
      <init-param>
         <param-name>cors.allowSubdomains</param-name>
         <param-value>true</param-value>
      </init-param>
      <init-param>
         <param-name>cors.supportedMethods</param-name>
         <param-value>GET, POST, HEAD, PUT, DELETE, OPTIONS</param-value>
      </init-param>
      <init-param>
         <param-name>cors.supportedHeaders</param-name>
         <param-value>Content-Type, Accept, Authorization</param-value>
      </init-param>
   </filter>
   <!-- ここまで追加 -->
   <filter-mapping>
      <filter-name>Global Localization Filter</filter-name>
      <url-pattern>/*</url-pattern>
      <dispatcher>REQUEST</dispatcher>
   </filter-mapping>
 
   <!-- ここから追加 -->
   <filter-mapping>
      <filter-name>CORS</filter-name>
      <url-pattern>/api/*</url-pattern>
      <url-pattern>/service/*</url-pattern>
      <url-pattern>/s/*</url-pattern>
      <url-pattern>/cmisbrowser/*</url-pattern>
   </filter-mapping>
   <!-- ここまで追加 -->
 
   <filter-mapping>
      <filter-name>CMIS security context cleaning filter</filter-name>
      <url-pattern>/cmisws/*</url-pattern>
   </filter-mapping>

３．Alfrescoを再起動します。


参考情報

CORSに間して

Cross-origin resource sharing
W3C Cross-Origin Resource Sharing
Using CORS

AlfrescoのCORSモジュールに関する情報は下記となります。

http://www.slideshare.net/jottley/cors-enable-alfresco-for-cors

http://software.dzhuvinov.com/cors-filter-installation.html

http://software.dzhuvinov.com/cors-filter-configuration.html

Related content

設定ガイド for CORS (Cross-Origin Resource Sharing)
設定ガイド for CORS (Cross-Origin Resource Sharing)
Alfresco connector for Jira (日本語版)
More like this
設定ガイド for クロスドメイン(CORS) ACS 6.2～
設定ガイド for クロスドメイン(CORS) ACS 6.2～
Alfresco connector for Confluence (日本語版)
More like this
オンプレミスの Alfresco Content Services のリクエスト URL フォーマット
オンプレミスの Alfresco Content Services のリクエスト URL フォーマット
Alfresco Content Services Documentation
More like this
インストールガイド for Alfresco関連プラグイン
インストールガイド for Alfresco関連プラグイン
Alfresco connector for Jira (日本語版)
More like this
検索結果の表示件数をカスタマイズする（Alfresco 5.2）
検索結果の表示件数をカスタマイズする（Alfresco 5.2）
Alfresco Content Services Documentation
More like this
インストールガイド for Alfresco認証プラグイン
インストールガイド for Alfresco認証プラグイン
Alfresco connector for Confluence (日本語版)
More like this

リックソフト株式会社 は、日本でトップレベルのAtlassian Platinum Solution Partnerです。
大規模ユーザーへの対応実績が認められたEnterpriseの認定をうけ、高度なトレーニング要件をクリアし、小規模から大規模のお客様まで対応可能な実績を示したパートナー企業です。

Copyright © Ricksoft Co., Ltd. プライバシーポリシー お問い合わせ