コンテンツにスキップ

SDI Web Service 設定

概要

サービス使用するため、ユーザー認証方法、アプリケーション認証、データベース接続文字列などの情報を設定します。
最小限cdbcServiceセッションにハイライトされた行を設定すれば、サービス動作します。

※SDI Web Serviceは当社別製品CDBCを内蔵しています。

Configurations

<configSections>

説明

configSections宣言を追加するために使用されます。変更しないでください。

XML example

  <configSections>
    <section name="oracle.manageddataaccess.client" type="OracleInternal.Common.ODPMSectionHandler, Oracle.ManagedDataAccess" />
    <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />
    <section name="cdbcService" type="CdbcServiceUtils.Config.CdbcConfigurationSectionHandler, CdbcServiceUtils" />
  </configSections>

<cdbcService>

説明

cdbcService関連の構成。
cdbcServiceを動作させるため、最小限下記のハイライトされた行を設定してください。

XML example 

  <cdbcService>
    <userAuthentication authMethod="None , Basic or UserPsk">
      <authenticatedUsers>
        <add userId="" userPsk="" comment=""/>
      </authenticatedUsers>
    </userAuthentication>
    <clientApplicationAuthentication authMethod="None or ApplicationPsk">
      <authenticatedApplications>
        <add applicationId="" applicationPsk="" comment="" />
      </authenticatedApplications>
    </clientApplicationAuthentication>
        <idps enabled="true" 
          accessBlockApplicationFailureCount="5"           
          accessBlockUserFailureCount="5" 
          accessBlockIpAdressFailureCount="20" 
          accessBlockSeconds="10" 
          failureResetSeconds="600" 
          clientServerMaxTimeLagSeconds="120" />
    <connectionStrings>
      <add name="" connectionString="" providerName=""/>
    </connectionStrings>
  </cdbcService>

<userAuthentication>

説明

認証されたユーザーのみがcdbcサービスにアクセスできます。 このセッションでは、ユーザ認証方式とpskを設定できます。

<userAuthentication authMethod="None , Basic or UserPsk">

Attributes

Attribute Description Value Remarks
authMethod ユーザー認証方法。 None , Basic or UserPsk None - ユーザー認証行いません。すべてのユーザーがサービスにアクセスできます。(推奨しません。開発やテストの場合のみ使用してください。)
Basic - IIS基本認証を使用します。
UserPsk - ユーザーごとに事前共有キー（ Pre-Shared Key）を使用します。
<authenticatedUsers>

説明

認証されたユーザーリストは、authenticatedUsersセクションに保存できます。 AuthenticatedUsersセクションを使用して、アプリケーション構成ファイルから認証済みユーザーを取得できます。そのプロパティは認証されたユーザー属性にマップされ、userIdを指定する単一の認証されたユーザーを取得できます。
この設定はauthMethod="UserPsk"の場合のみ有効です

<authenticatedUsers>
  <add userId="" userPsk="" comment=""/>
</authenticatedUsers>

Attributes

Attribute Description Value Remarks
userId User ID String
userPsk ユーザーの事前共有キー (Pre-Shared Key 16 digital) String
comment ユーザーに対するコメント。管理用、システムでは使用されません。 String

<clientApplicationAuthentication>

説明

認証されたクライアントアプリケーションのみがcdbcサービスにアクセスできます。このセッションでは、クライアントアプリケーションの認証方法とpsksを設定できます。

    <clientApplicationAuthentication authMethod="None or ApplicationPsk">

Attributes

Attribute Description Value Remarks
authMethod クライアントアプリケーションの認証方法。 None - アプリケーション認証行いません。すべてのアプリケーションがサービスにアクセスできます。
ApplicationPsk - アプリケーションごとに事前共有キー（ Pre-Shared Key）を使用します。
<authenticatedApplications>

説明

認証されたアプリケーションのリストは、authenticatedApplicationsセクションに保存できます。 AuthenticatedApplicationsセクションを使用して、アプリケーション構成ファイルから認証済みアプリケーションを取得できます。そのプロパティは認証されたアプリケーション属性にマップされ、applicationIdを指定する単一の認証されたアプリケーションを取得できます。
この設定はauthMethod="ApplicationPsk"の場合のみ有効です。

      <authenticatedApplications>
        <add applicationId="" applicationPsk="" comment="" />
      </authenticatedApplications>

Attributes

Attribute Description Value Remarks
applicationId Applicaion ID String
applicationPsk アプリケーションの事前共有キー (Pre-Shared Key 16 digital) String
comment アプリケーションに対するコメント。管理用、システムでは使用されません。 String

<idps>

説明

Idpsは、不正アクセスをブロックするために使用されます。 一定回数以上認証失敗の場合、アクセスは指定された期間ブロックされます。

        <idps enabled="true" 
          accessBlockApplicationFailureCount="5"           
          accessBlockUserFailureCount="5" 
          accessBlockIpAdressFailureCount="20" 
          accessBlockSeconds="10" 
          failureResetSeconds="600"  />
Attributes

Attribute Description Value Remarks
enabled Idpsを有効または無効にします。 true or false
default true
accessBlockApplicationFailureCount ブロック開始時のアプリケーション認証失敗回数。 int>=1
default 5		 同じIPと同じアプリケーションIDからのアクセスをカウントします。
accessBlockUserFailureCount ブロック開始時のユーザー認証失敗回数。 int>=1
default 5		 同じIPと同じユーザーIDからのアクセスをカウントします。
accessBlockIpAdressFailureCount ブロック開始時の認証失敗回数。 int>=1
default 20		 同じIPからのアクセスをカウント
accessBlockSeconds アクセスがブロックされる秒数を設定します。 int>=1
default 10
failureResetSeconds 一定時間経過して認証エラーがない場合、失敗カウントは0にリセットされます。failureResetSecondsはリセット時間を秒単位で設定します。 int>accessBlockSeconds
default 600

<connectionStrings>

説明

cdbcサービスで使用される接続文字列は、connectionStringsセクションに保存できます。 connectionStringsの詳細については、下記のドキュメントを参照してください。
Oracle :
SQLServer :
MySQL: Creating a Connector/NET Connection String
PostgreSQL:Npgsql Connection string parameters 

    <connectionStrings>
      <add name="" connectionString="" />
    </connectionStrings>

<log4net>

説明

Cdbcはlog4netを使用して、システムと監査ログをログに記録します。 詳細については、log4netのドキュメントを参照してください。

  <log4net>
    <appender name="RollingLogFileAppenderSystem" type="log4net.Appender.RollingFileAppender,log4net">
    ...
    </appender>
    <appender name="RollingLogFileAppenderAudit" type="log4net.Appender.RollingFileAppender,log4net">
    ...
    </appender>
    <logger name="audit">
      <appender-ref ref="RollingLogFileAppenderAudit"/>
    </logger>
    <logger name="system">
      <appender-ref ref="RollingLogFileAppenderSystem"/>
    </logger>
  </log4net>

<serviceModel>

説明

serviceModelセッションには、サービスのいくつかのwcf構成が含まれています。 wcfについて深い知識がある場合は、要件に合わせて変更できます。 詳細については、Microsoftのドキュメントを参照してください。

  <system.serviceModel>
    <bindings>
      <basicHttpBinding>
        <binding maxReceivedMessageSize="5798464">
        </binding>
      </basicHttpBinding>
      <basicHttpsBinding>
        <binding maxReceivedMessageSize="5798464">
        </binding>
      </basicHttpsBinding>
    </bindings>
    <behaviors>
      <serviceBehaviors>
        <behavior>
          <serviceMetadata httpGetEnabled="false" httpsGetEnabled="false"/>
          <serviceDebug includeExceptionDetailInFaults="false" httpHelpPageEnabled="false" httpsHelpPageEnabled="false"/>
        </behavior>
      </serviceBehaviors>
    </behaviors>
    <protocolMapping>
        <add binding="basicHttpsBinding" scheme="https" />
    </protocolMapping>    
    <serviceHostingEnvironment aspNetCompatibilityEnabled="true" multipleSiteBindingsEnabled="true" />
  </system.serviceModel>

<oracle.manageddataaccess.client>

説明

SDI Web ServiceはODP.NET管理対象ドライバを使っています。ODP.NET管理対象ドライバの関連設定です。

<oracle.manageddataaccess.client>
    <version number="*">
    </version>
</oracle.manageddataaccess.client>
Back to top