How To：使用程式碼存取安全性原則來限制組件

建立名為 FileIO 的新 Microsoft Visual C#™ 開發工具類別庫專案，將 class1.cs 重新命名為 FileIO.cs。

為組件加上增強名稱。
加上增強名稱會以數位簽署組件，可以防止組件遭到竄改。增強名稱的公開金鑰元件也提供程式碼存取安全性原則的加密式增強式舉證。系統管理員可以使用增強名稱唯一識別組件，以套用原則。

使用固定的組件版本。開啟 Assemblyinfo.cs 並設定 AssemblyVersion 屬性，如下所示：

[assembly: AssemblyVersion("1.0.0.1")]

將下列 using 陳述式加入 FileIO.cs 的最上面：

using System.IO;
using System.Text;

將 Class1 重新命名為 FileWrapper，並密封類別以防止繼承。

public sealed class FileWrapper

將預設建構函式重新命名，以符合類別名稱，並將其變更為 private，這會防止建立 FileWrapper 類別的執行個體。這個類別只提供靜態方法。

加入以下公用方法，使其從指定的檔案讀取。

public static string ReadFile(string filename)
{
byte[] fileBytes = null;
long fileSize = -1;
Stream fileStream = null;

try
  {
if(null == filename)
    {
throw new ArgumentException("Missing filename");
    }
// 標準化及驗證提供的檔案名稱
// GetFullPath：
// - 檢查無效的字元 (Path.InvalidPathChars 所定義的)
// - 檢查 Win32 非檔案類型裝置名稱，包括
//   實體磁碟機、並列與序列埠、管道、郵件插槽
//   等等
// - 將檔案路徑正常化

filename = Path.GetFullPath(filename);
fileStream = File.OpenRead(filename);
if(!fileStream.CanRead)
    {
throw new Exception("Unable to read from file.");
    }
fileSize = fileStream.Length;
fileBytes = new byte[fileSize];
fileStream.Read(fileBytes, 0, Convert.ToInt32(fileSize));
return Encoding.ASCII.GetString(fileBytes);
  }
catch (Exception ex)
  {
throw ex;
  }
finally
  {
if (null != fileStream)
fileStream.Close();
  }
}

將名為 FileIOWeb 的新 C# ASP.NET Web 應用程式專案加入目前的解決方案。

在新專案中加入參照 FileIO 專案的一個專案參照。

在 WebForm1.aspx 中加入文字方塊，讓使用能夠輸入路徑與檔案名稱。將其 Text 屬性設定為 c:\temp\somefile.txt，並將 ID 設定為 txtFileName。

在 WebForm1.aspx 加入一個按鈕，並將其 Text 屬性設定為讀取檔案，ID 設定為 btnReadFile。

連按兩下 [讀取檔案] 按鈕，將以下程式碼加入事件處理常式：

string s = FileIO.FileWrapper.ReadFile( txtFileName.Text );
Response.Write(s);

建立解決方案。

使用記事本建立名為 Somefile.txt 的文字檔，然後將檔案放入 C:\temp 目錄中。另外將一份複本放入 C:\ 根目錄中。

執行 Web 應用程式，然後按一下 [讀取檔案]。
就會顯示文字檔的內容。

在文字方塊中輸入 c:\somefile.txt，再按一下 [讀取檔案]。
就會顯示文字檔的內容。

從 [管理工具] 程式集資料夾啟動 .NET Framework 1.1 版設定工具。

展開 [Runtime 安全性原則] 節點。
會顯示三個等級的程式碼存取安全性原則：[企業]、[電腦] 及 [使用者]。您可以設定的程式碼存取安全性原則的第四個等級是應用程式領域等級。ASP.NET 實作應用程式領域等級原則，但是並非使用 .NET Framework 1.1 版設定工具維護。若要編輯 ASP.NET 原則，必須使用文字編輯器。

如需 ASP.NET 原則和如何使用原則的詳細資訊，請參閱單元 9＜配合 ASP.NET 使用程式碼存取安全性＞。

展開 [電腦] 節點。
就會顯示 [程式碼群組] 和 [權限集合] 資料夾。每個原則檔包含一個程式碼群組的階層集合。程式碼群組用於指派權限給組件。程式碼群組包含兩個元素：

權限集合 是一個群組，包含個別程式碼存取安全性權限的集合。個別權限代表程式碼存取特定資源類型或執行特定類型特權操作的權利。

在 [權限集合] 上按一下滑鼠右鍵，然後按一下 [新增]。

在 [名稱] 欄位中輸入「RestictedFileIO」，然後按一下 [下一步]。

從 [可用的權限] 清單中選取 [FileIO]，然後按一下 [加入]。

在 [檔案路徑] 欄位中輸入「c:\temp」，再選取 [讀取] 與 [路徑描述]。
FileIO 組件用於標準化及驗證提供之檔案名稱的 Path.GetFullPath 函式需要路徑描述權限。

FileIO 組件使用的 File.OpenRead 方法需要讀取權限。

按一下 [確定]。

從 [可用的權限] 清單中選取 [安全性]，然後按一下 [加入]。
FileIO 組件除了 FileIOPermission 以外，也需要這個權限才能執行。要執行的權限是以 SecurityPermission 表示，其 Flags 屬性設定為 SecurityPermissionFlag.Execution。

按一下 [啟用組件執行]，然後按一下 [確定]。

按一下 [完成]，完成權限集合的建立。
現在您已建立好名為 RestrictedFileIO 的新權限集合，其中包含一個限制的 FileIOPermission，允許到 C:\Temp 目錄的讀取和路徑描述，以及一個限制的 SecurityPermission，允許組件執行。

展開 [程式碼群組]，然後展開 [All_Code]。

在 [All_Code] 上按一下滑鼠右鍵，然後按一下 [新增]。

輸入「FileIOAssembly」作為程式碼群組名稱，然後按一下 [下一步]。

從 [選擇這個程式碼群組的條件類型] 下拉式清單中選取 [StrongName]。
您使用這個程式碼群組將 RestrictedFileIO 定義的特定權限套用至 FileIO 組件。增強名稱提供加密的增強名稱來唯一識別組件。

若要指定 FileIO 組件的公開金鑰 (因為組件有增強名稱，所以有這個金鑰)，按一下 [匯入]，然後瀏覽至包含 FileIO.dll 的專案輸出資料夾。按一下 [開啟]，從組件解壓縮公開金鑰。

按一下 [下一步]，然後從 [使用現有的權限集合] 下拉式清單中選取 [RestrictedFileIO]。

按一下 [下一步]，再按一下 [完成]，完成程式碼群組的建立。
現在您已建立好新的程式碼群組，會將 RestrictedFileIO 權限集合定義的權限套用至 FileIO 組件。

在右邊的視窗中選取 [FileIOAssembly] 程式碼群組，然後按一下 [編輯程式碼群組屬性]。

選取 [這個原則層級只會具有這個程式碼群組使用權限集合的使用權限] 和 [這個層級以下的原則層級不會被評估]。
在目前電腦等級或從 ASP.NET 應用程式領域等級為程式碼群組選取這些屬性，會影響授與 FileIO 組件的權限集合。這可以確保只會授與組件由您先前建立之 RestrictedFileIO 組件集合定義的權限。

注意 如果不選取這些選項，預設電腦原則會授與組件完全信任，因為組件是安裝在本機電腦上，適用 My_Computer_Zone 設定。

按一下 [確定] 以關閉 [內容] 對話方塊。

使用 Gacutil.exe 公用程式將 FileIO 組件安裝到 GAC 中。
建置後可以呼叫 Gacutil.exe，以確保順利在 Microsoft Visual Studio® .NET 中建立好組件之後，它會放在 GAC 裡。

重新建立解決方案。

從指令行執行 Iisreset.exe，以強制回收 ASP.NET 處理序。
這會強制重新計算 FileIO 組件的權限授與。如果自您上次執行 Web 應用程式之後，ASP.NET 應用程式領域仍在作用中，可能是組件仍然由 ASP.NET 快取著。

執行 Web 應用程式，然後按一下 [讀取檔案]。
文字檔案的內容應會順利顯示。您建立的原則允許 FileIO 組件從 C:\Temp 和底下的目錄讀取檔案。

在文字方塊中輸入 C:\somefile.txt，然後按一下 [讀取檔案]。
應該會產生 SecurityException，因為您設定的程式碼存取安全性原則不允許 C:\Temp 目錄之外的檔案 I/O。

例外狀況的詳細資訊會顯示 FileIOPermission 已失敗，如下所示：

System.Security.SecurityException: Request for the permission of type 
System.Security.Permissions.FileIOPermission, mscorlib, Version=1.0.5000.0, 
Culture=neutral, PublicKeyToken=b77a5c561934e089 failed.