Dosya API’si yapılandırmaFile API configuration

Dosya API'sinin davranışları, kayıt defterindeki ayarlar aracılığıyla yapılandırılabilir.The File API's behavior can be configured through settings in the registry.

Dosya API'si iki tür koruma sağlar; yerel koruma ve PFile koruma.The File API provides two kinds of protection; native protection and PFile protection.

  • Yerel koruma - dosya, MIME türüne (dosya adı uzantısı) dayanılarak bir AD RMS dosya biçimine korunur.Native protection - the file is protected to an AD RMS format based on its MIME type (file name extension).
  • PFile koruma - dosya, AD RMS Korumalı Dosya (PFile) biçimine korunur.PFile protection - the file is protected to the AD RMS Protected File (PFile) format.

Desteklenen dosya biçimleri hakkında daha fazla bilgi için bkz. dosya API dosya destek ayrıntıları bu makaledeki.For more information about supported file formats, see File API File Support Details in this article.

Anahtar/Anahtar Değer türleri ve açıklamalarıKey/Key Value types and descriptions

Aşağıdaki bölümlerde, şifrelemeyi denetleyen anahtarları ve anahtar değerleri açıklanır.The following sections describe the keys and key values that control encryption.

HKEY_LOCAL_MACHINE\Software\Microsoft\MSIPC\FileProtection

Tür: AnahtarType: Key

Açıklama: Dosya API'si için genel yapılandırmayı içerir.Description: Contains general configuration for the File API.

HKEY_LOCAL_MACHINE\Software\Microsoft\MSIPC\FileProtection\<EXT>

Tür: AnahtarType: Key

Açıklama: Belirli bir dosya uzantısı için yapılandırma bilgilerini belirtir. Örneğin, TXT, JPG ve benzeri.Description: Specifies configuration information for a specific file extension; for example, TXT, JPG, and so on.

  • Joker karakter, ' *', izin verilir; Ancak, belirli bir uzantı için bir ayarı, üzerinde joker karakter ayarı öncelik alır.The wildcard character, '*', is allowed; however, a setting for a specific extension takes precedence over the wildcard setting. Joker karakter, Microsoft Office dosyaları ayarlarını etkilemez; bunlar, dosya türüne göre açıkça devre dışı bırakılmalıdır.The wildcard character does not affect settings for Microsoft Office files; these must be explicitly disabled by file type.
  • Bir uzantısı olmayan dosyaları belirtmek için, '.' kullanınTo specify files that do not have an extension, use '.'
  • Belirtmeyin '.'; belirli bir dosya uzantısı için anahtarı belirtirken karakter Örneğin, HKEY_LOCAL_MACHINE\Software\Microsoft\MSIPC\FileProtection\TXT txt dosyaları için ayarları belirtmek için.Do not specify the '.' character when specifying the key for a specific file extension; for example, use HKEY_LOCAL_MACHINE\Software\Microsoft\MSIPC\FileProtection\TXT to specify settings for .txt files. (HKEY_LOCAL_MACHINE\Software\Microsoft\MSIPC\FileProtection\.TXT girişini kullanmayın).(Do not use HKEY_LOCAL_MACHINE\Software\Microsoft\MSIPC\FileProtection\.TXT).

Koruma davranışını belirtmek için ayarlanmış şifreleme anahtar değeri.To specify the protection behavior, set the Encryption value in the key. Şifreleme değeri ayarlanmazsa, dosya türü için varsayılan davranış gözlenir.If the Encryption value is not set, the default behavior for the file type is observed.

HKEY_LOCAL_MACHINE\Software\Microsoft\MSIPC\FileProtection\<EXT>\Encryption*

Tür: REG_SZType: REG_SZ

Açıklama: Üç değerden birini içerir:Description: Contains one of three values:

  • Kapalı: Şifreleme devre dışı bırakıldı.Off: Encryption is disabled.

Not

Bu ayarın, şifrelemeyle ilgisi yoktur.This setting has no bearing on decryption. İster yerel isterse Pfile koruması kullanılarak şifrelenmiş olsun, kullanıcının EXTRACT hakkı olduğu müddetçe şifrelenmiş herhangi bir dosyanın şifresi çözülebilir.Any encrypted file, whether encrypted using Native or Pfile protection, can be decrypted, as long as the user has the EXTRACT right.

  • Yerel: Yerel şifreleme kullanılır.Native: Native encryption is used. Office dosyaları için, şifrelenmiş dosya, özgün dosyayla aynı uzantıya sahip olacaktır.For Office files the encrypted file will have the same extension as the original file. Örneğin, .docx dosya uzantılı bir dosya, uzantısı .docx olan bir dosyaya şifrelenir.For example, a file with the .docx file extension will be encrypted to a file with an extension of .docx. Yerel koruma uygulanabilen diğer dosyalar için dosya, zzz biçimindeki bir uzantıya sahip bir dosya olarak şifrelenir; burada zzz özgün dosya uzantısıdır.For other files that can have native protection applied, the file will be encrypted to a file with an extension of the format pzzz, where zzz is the original file extension. Örneğin .txt dosyaları, .ptxt uzantılı bir dosyaya şifrelenir.For example, .txt files will be encrypted to a file with an extension of .ptxt. Yerel koruma uygulanmış olan dosya uzantıları listesi aşağıdadır.A list of file extensions that can have native protection applied follows.

  • Pfile: PFile şifrelemesi kullanılır.Pfile: PFile encryption is used. Şifrelenmiş dosyada, özgün uzantıya eklenmiş .pfile olacaktır.The encrypted file will have .pfile appended to the original extension. Örneğin, şifreleme sonrasında bir .txt dosyasının uzantısı .txt.pfile olacaktır.For example, after encryption, a .txt file, will have an extension of .txt.pfile.

Not

Bu ayarın Office dosya biçimleriyle ilgisi yoktur.This setting has no bearing on Office file formats. Örneğin, HKEY_LOCAL_MACHINE\Software\Microsoft\MSIPC\FileProtection\DOCX\Encryption değeri ayarı "Pfile” olarak ayarlanırsa .docx dosyaları yine yerel koruma kullanılarak şifrelenir ve şifrelenmiş dosyanın dosya uzantısı hala .docx olur.For example, if the HKEY_LOCAL_MACHINE\Software\Microsoft\MSIPC\FileProtection\DOCX\Encryption value is set to "Pfile”, .docx files will still be encrypted using native protection, and the encrypted file will still have a file extension of .docx.

Başka bir değer ayarlanması veya değer ayarlanmaması, varsayılan davranışla sonuçlanır.Setting any other value or setting no value results in default behavior.

Farklı dosya biçimleri için varsayılan davranışDefault behavior for different file formats

  • Office dosyaları Yerel şifreleme etkinleştirilmiştir.Office files Native encryption is enabled.
  • txt, xml, jpg, jpeg, pdf, png, tiff, bmp, gif, giff, jpe, jfif, jif dosyaları Yerel şifreleme etkinleştirilmiştir (xxx, pxxx olur)txt, xml, jpg, jpeg, pdf, png, tiff, bmp, gif, giff, jpe, jfif, jif files Native encryption is enabled (xxx becomes pxxx)
  • Diğer tüm dosyalar Şifreleme korumalı dosya (pfile) etkinleştirilmiştir (xxx, xxx.pfile olur)All other files Encryption is protected file (pfile) enabled (xxx become xxx.pfile)

Engellenmiş bir dosya türü üzerinde şifreleme yapılmaya çalışılırsa bir IPCERROR_FILE_ENCRYPT_BLOCKED hatası oluşur.If encryption is attempted on a file type that is blocked, an IPCERROR_FILE_ENCRYPT_BLOCKED error occurs.

Dosya API’si - Dosya Destek AyrıntılarıFile API - File Support Details

Hiçbir dosya türü (uzantı) için yerel destek eklenebilir.Native support can be added for any file type (extension). Örneğin, herhangi bir <ext> (Office hariç) uzantısının yönetim yapılandırması “YEREL” ise *.p<ext> uzantısı kullanılır.For instance, any extension <ext> (non-office), *.p<ext> will be used if the admin configuration for that extension is "NATIVE".

Office dosyalarıOffice files

  • Dosya uzantıları: doc, dot, xla, xls, xlt, pps, ppt, docm, docx, dotm, dotx, xlam, xlsb, xlsm, xlsx, xltm, xltx, xps, potm, potx, ppsx, ppsm, pptm, pptx, thmx, vsdx, vsdm, vssx, vssm, vstx ve vstm.File extensions: doc, dot, xla, xls, xlt, pps, ppt, docm, docx, dotm, dotx, xlam, xlsb, xlsm, xlsx, xltm, xltx, xps, potm, potx, ppsx, ppsm, pptm, pptx, thmx, vsdx, vsdm, vssx, vssm, vstx, and vstm.
  • Koruma türü = Yerel (varsayılan): sample.docx sample.docx’a şifrelenirProtection type = Native (default): sample.docx is encrypted to sample.docx
  • Koruma türü = Pfile: Office dosyaları için yerel aynı etkiye sahiptir.Protection type = Pfile: For Office files, has the same effect as Native.
  • Kapalı: Şifreleme devre dışı bırakır.Off: Disables encryption.

PDF dosyalarıPDF files

  • Koruma türü = Yerel: sample.pdf şifrelenir ve sample.ppdf olarak adlandırılırProtection type = Native: sample.pdf is encrypted and named sample.ppdf
  • Koruma türü = Pfile: sample.pdf şifrelenir ve sample.pdf.pfile olarak adlandırılırProtection type = Pfile: sample.pdf is encrypted and named sample.pdf.pfile.
  • Kapalı: Şifreleme devre dışı bırakır.Off: Disables encryption.

Diğer tüm dosya biçimleriAll other file formats

  • Koruma türü = Pfile: sample.zzz şifrelenir ve sample.zzz.pfile olarak adlandırılır; burada zzz özgün dosya uzantısıdır.Protection type = Pfile: sample.zzz is encrypted and named sample.zzz.pfile; where zzz is the original file extension.
  • Kapalı: Şifreleme devre dışı bırakır.Off: Disables encryption.

ÖrneklerExamples

Aşağıdaki ayarlar, txt dosyaları için PFile şifrelemeyi etkinleştirir.The following settings enable PFile encryption for txt files. Office dosyalarına yerel koruma (varsayılan) uygulanmış olacaktır, txt dosyalarına PFile koruma uygulanmış olacaktır ve diğer tüm dosyalarda koruma engellenmiş olacaktır (varsayılan).Office files will have native protection applied (by default), txt files will have PFile protection applied, and all other files will have protection blocked (by default).

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         MSIPC
            FileProtection
               txt
                  Encryption = Pfile

Aşağıdaki ayarlar, txt dosyaları dışında tüm Office harici dosyalar için PFile şifrelemeyi etkinleştirir.The following settings enable PFile encryption for all non-Office files except txt files. Office dosyalarına yerel koruma (varsayılan olarak) uygulanmış olacaktır, txt dosyalarında koruma engellenmiş olacaktır ve diğer tüm dosyalara PFile koruma uygulanmış olacaktır.Office files will have native protection applied (by default), txt files will have protection blocked, and all other files will have PFile protection applied.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         MSIPC
            FileProtection
               *
                  Encryption = Pfile
               txt
                  Encryption = Off

Aşağıdaki ayarlar, docx dosyaları için yerel şifrelemeyi devre dışı bırakır.The following settings disable native encryption for docx files. docx dosyaları hariç Office dosyalarına yerel koruma (varsayılan) uygulanmış olacaktır ve diğer tüm dosyalarda koruma engellenmiş olacaktır (varsayılan).Office files, except for docx files, will have native protection applied (by default) and all other files will have protection blocked (by default).

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         MSIPC
            FileProtection
               docx
                  Encryption = Off