<trustInfo> 要素 (ClickOnce アプリケーション)

[アーティクル]
03/10/2023

アプリケーションをクライアントコンピューター上で実行するのに必要な最低限のセキュリティ権限について説明します。

構文


      <trustInfo>
   <security>
      <applicationRequestMinimum>
         <PermissionSet
            ID
            Unrestricted>
            <IPermission
               class
               version
               Unrestricted
            />
         </PermissionSet>
         <defaultAssemblyRequest
            permissionSetReference
         />
         <assemblyRequest
            name
            permissionSetReference
         />
      </applicationRequestMinimum>
      <requestedPrivileges>
         <requestedExecutionLevel
            level
            uiAccess
         />
      </requestedPrivileges>
   </security>
</trustInfo>

要素と属性

trustInfo 要素は必須です。この要素は asm.v2 名前空間にあります。これには、属性はなく次の要素を含みます。

security

必須。この要素は trustInfo 要素の子です。 applicationRequestMinimum 要素を含み、属性はありません。

applicationRequestMinimum

必須。この要素は、 security 要素の子であり、 PermissionSet、 assemblyRequest、および defaultAssemblyRequest 要素が含まれています。この要素には属性はありません。

PermissionSet

必須。この要素は applicationRequestMinimum 要素の子であり、 IPermission 要素を含んでいます。この要素には、次の属性があります。

ID

必須。アクセス許可セットを識別します。この属性は任意の値にできます。この ID は defaultAssemblyRequest および assemblyRequest 属性で参照されます。
version

必須。アクセス許可のバージョンを識別します。通常、この値は 1です。

IPermission

省略可能。この要素は PermissionSet 要素の子です。 IPermission 要素には、.NET Framework 内のアクセス許可クラスを正しく指定します。 IPermission 要素には次の属性がありますが、アクセス許可クラスのプロパティに対応する追加の属性を持つことができます。アクセス許可の具体的な構文については、Security.config ファイル内の例を参照してください。

class

必須。アクセス許可クラスを厳密な名前で指定します。たとえば、次のコードでは FileDialogPermission 型を指定しています。

System.Security.Permissions.FileDialogPermission, mscorlib, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
version

必須。アクセス許可のバージョンを識別します。通常、この値は 1です。
Unrestricted

必須。アプリケーションの実行に、このアクセス許可を無制限で与える必要があるかどうかを指定します。 trueに設定すると、アクセス許可は無条件に与えられます。 falseに設定するか、この属性を定義しない場合は、 IPermission タグで定義されているアクセス許可固有の属性に従って制限されます。アクセス許可の例を次に示します。
```
<IPermission
  class="System.Security.Permissions.EnvironmentPermission, mscorlib, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
  version="1"
  Read="USERNAME" />
<IPermission
  class="System.Security.Permissions.FileDialogPermission, mscorlib, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
  version="1"
  Unrestricted="true" />
```
この例の EnvironmentPermission の宣言では、アプリケーションのアクセス許可を環境変数 USERNAME の読み取りのみに制限しています。これに対し、 FileDialogPermission の宣言では、アプリケーションにすべての FileDialog クラスを無制限に使用できるようにしています。

defaultAssemblyRequest

省略可能。すべてのアセンブリに付与されるアクセス許可のセットを指定します。この要素は applicationRequestMinimum 要素の子であり、以下の属性があります。

permissionSetReference

必須。既定のアクセス許可として使用するアクセス許可セットの ID を指定します。アクセス許可セットは、 PermissionSet 要素で宣言します。

assemblyRequest

省略可能。特定のアセンブリのアクセス許可を識別します。この要素は applicationRequestMinimum 要素の子であり、以下の属性があります。

Name

必須。アセンブリ名を識別します。
permissionSetReference

必須。このアセンブリに必要なアクセス許可セットの ID を指定します。アクセス許可セットは、 PermissionSet 要素で宣言します。

requestedPrivileges

省略可能。この要素は security 要素の子であり、 requestedExecutionLevel 要素を含んでいます。この要素には属性はありません。

requestedExecutionLevel

省略可能。アプリケーションを実行するために必要なセキュリティレベルを指定します。この要素には子はなく、次の属性があります。

Level

必須。アプリケーションが要求するセキュリティレベルを指定します。次のいずれかの値になります。

asInvoker。アクセス許可の追加要求は行いません。このレベルでは、追加の信頼確認は不要です。

highestAvailable。親プロセスが利用できる最上位のアクセス許可を要求します。

requireAdministrator。完全な管理者のアクセス許可を要求します。

ClickOnce アプリケーションは、asInvoker 値でのみインストールされます。それ以外の値でインストールすると、エラーが発生します。
uiAccess

省略可能。アプリケーションが、保護されたユーザーインターフェイス要素へのアクセスを必要とするかどうかを指定します。指定できる値は、 true または falseです。既定値は false です。署名付きのアプリケーションのみ、true の値を設定する必要があります。

解説

ClickOnce アプリケーションが、クライアントコンピューターによって既定で与えられる以上のアクセス許可を求める場合は、より高いレベルの信頼を与えるかどうかを確認するメッセージが、共通言語ランタイムの Trust Manager によって表示されます。ユーザーが信頼を与えない場合、アプリケーションは実行されません。信頼を与えた場合は、ここで要求されたアクセス許可で実行されます。

配置マニフェストに有効な信頼ライセンスがある場合には、 defaultAssemblyRequest や assemblyRequest を使用して要求されるすべてのアクセス許可は、ユーザーに確認することなく与えられます。

アクセス許可の昇格の詳細については、「ClickOnce アプリケーションのセキュリティ」を参照してください。ポリシー配置の詳細については、「 Trusted Application Deployment Overview」を参照してください。

例

次の 3 つのコード例では、ClickOnce による配置のアプリケーションマニフェストで使用する、既定の名前付きセキュリティゾーン (Internet、LocalIntranet、および FullTrust) に対応する trustInfo 要素を示しています。

最初の例は、Internet セキュリティゾーンで使用できる既定のアクセス許可の trustInfo 要素を示しています。

<trustInfo>
    <security>
      <applicationRequestMinimum>
        <PermissionSet ID="Internet">
          <IPermission
            class="System.Security.Permissions.FileDialogPermission, mscorlib, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
            version="1"
            Access="Open" />
          <IPermission
           class="System.Security.Permissions.IsolatedStorageFilePermission, mscorlib, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
            version="1"
            Allowed="DomainIsolationByUser"
            UserQuota="10240" />
          <IPermission
            class="System.Security.Permissions.SecurityPermission, mscorlib, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
            version="1"
            Flags="Execution" />
          <IPermission
            class="System.Security.Permissions.UIPermission, mscorlib, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
            version="1"
            Window="SafeTopLevelWindows"
            Clipboard="OwnClipboard" />
          <IPermission
            class="System.Drawing.Printing.PrintingPermission, System.Drawing, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
            version="1"
            Level="SafePrinting" />
        </PermissionSet>
        <defaultAssemblyRequest permissionSetReference="Internet" />
      </applicationRequestMinimum>
    </security>
  </trustInfo>

2 番目の例は、LocalIntranet セキュリティゾーンで使用できる既定のアクセス許可の trustInfo 要素を示しています。

<trustInfo>
    <security>
      <applicationRequestMinimum>
        <PermissionSet ID="LocalIntranet">
          <IPermission
            class="System.Security.Permissions.EnvironmentPermission, mscorlib, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
            version="1"
            Read="USERNAME" />
          <IPermission
            class="System.Security.Permissions.FileDialogPermission, mscorlib, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
            version="1"
            Unrestricted="true" />
          <IPermission
            class="System.Security.Permissions.IsolatedStorageFilePermission, mscorlib, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
            version="1"
            Allowed="AssemblyIsolationByUser"
            UserQuota="9223372036854775807"
            Expiry="9223372036854775807"
            Permanent="True" />
          <IPermission
            class="System.Security.Permissions.ReflectionPermission, mscorlib, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
            version="1"
            Flags="ReflectionEmit" />
          <IPermission
            class="System.Security.Permissions.SecurityPermission, mscorlib, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
            version="1"
            Flags="Assertion, Execution" />
          <IPermission
            class="System.Security.Permissions.UIPermission, mscorlib, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
            version="1"
            Unrestricted="true" />
          <IPermission
            class="System.Net.DnsPermission, System, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
            version="1"
            Unrestricted="true" />
          <IPermission
            class="System.Drawing.Printing.PrintingPermission, System.Drawing, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
            version="1"
            Level="DefaultPrinting" />
          <IPermission
            class="System.Diagnostics.EventLogPermission, System, Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
            version="1" />
        </PermissionSet>
        <defaultAssemblyRequest permissionSetReference="LocalIntranet" />
      </applicationRequestMinimum>
    </security>
</trustInfo>

3 番目の例は、FullTrust セキュリティゾーンで使用できる既定のアクセス許可の trustInfo 要素を示しています。

<trustInfo>
  <security>
    <applicationRequestMinimum>
      <PermissionSet ID="FullTrust" Unrestricted="true" />
      <defaultAssemblyRequest permissionSetReference="FullTrust" />
    </applicationRequestMinimum>
  </security>
</trustInfo>

次の方法で共有