Klasse System.Xml.XmlSecureResolver

De XmlUrlResolver klasse is de standaardresolver voor alle klassen in de System.Xml naamruimte. Het wordt gebruikt voor het laden van XML-documenten en het oplossen van externe resources, zoals entiteiten, DTD's of schema's, en het importeren of opnemen van instructies.

U kunt deze standaardinstelling overschrijven door het XmlResolver object op te geven dat u wilt gebruiken. Als u bijvoorbeeld de resources wilt beperken waartoe de onderliggende XmlResolver resources toegang hebben, kunt u een XmlSecureResolver object gebruiken.

XmlSecureResolver omvat een concrete implementatie van XmlResolver en beperkt de toegang tot de resources waartoe de onderliggende XmlResolver toegang heeft. Heeft bijvoorbeeld XmlSecureResolver de mogelijkheid om omleiding tussen domeinen te verbieden, die afkomstig is van een ingesloten URI-verwijzing (Uniform Resource Identifier).

Wanneer u een XmlSecureResolver object maakt, geeft u een geldige XmlResolver implementatie op, samen met een URL, een exemplaar van een bewijsobject of een machtigingenset, die wordt gebruikt door de XmlSecureResolver beveiliging te bepalen. Er wordt een System.Security.PermissionSet gegenereerd of de bestaande wordt gebruikt en PermissionSet.PermitOnly wordt erop aangeroepen om de onderliggende XmlResolver te beveiligen.

Een beveiligde resolver gebruiken

1. Maak een XmlSecureResolver met de juiste machtigingenset.

2. Maak een XmlReaderSettings object dat gebruikmaakt van het XmlSecureResolver object.

   XmlReaderSettings settings = new XmlReaderSettings();
   settings.XmlResolver = myResolver;
   

   Dim settings As New XmlReaderSettings()
   settings.XmlResolver = myResolver
   

3. Geef het XmlReaderSettings object door aan de Create methode wanneer u het XmlReader object maakt.

   XmlReader reader = XmlReader.Create("books.xml", settings);
   

   Dim reader As XmlReader = XmlReader.Create("books.xml", settings)
   

Toegang beperken met behulp van een URL

Gebruik de XmlSecureResolver(XmlResolver, String) constructor om een XmlSecureResolver object te maken dat alleen toegang heeft tot uw lokale intranetsite.

XmlSecureResolver myResolver = new XmlSecureResolver(new XmlUrlResolver(), "http://myLocalSite/");

Dim myResolver As New XmlSecureResolver(New XmlUrlResolver(), "http://myLocalSite/")

Toegang beperken met behulp van een machtigingenset

1. Maak een WebPermission object.

   WebPermission myWebPermission = new WebPermission(PermissionState.None);
   

   Dim myWebPermission As New WebPermission(PermissionState.None)
   

2. Geef de URL's op waartoe u toegang wilt toestaan.

   myWebPermission.AddPermission(NetworkAccess.Connect, "http://www.contoso.com/");
   myWebPermission.AddPermission(NetworkAccess.Connect, "http://litwareinc.com/data/");
   

   myWebPermission.AddPermission(NetworkAccess.Connect, "http://www.contoso.com/")
   myWebPermission.AddPermission(NetworkAccess.Connect, "http://litwareinc.com/data/")
   

3. Voeg de webmachtigingen toe aan het PermissionSet object.

   PermissionSet myPermissions = new PermissionSet(PermissionState.None);
   myPermissions.AddPermission(myWebPermission);
   

   Dim myPermissions As New PermissionSet(PermissionState.None)
   myPermissions.AddPermission(myWebPermission)
   

4. Gebruik de XmlSecureResolver(XmlResolver, PermissionSet) constructor om een XmlSecureResolver object te maken met behulp van de machtigingenset.

   XmlSecureResolver myResolver = new XmlSecureResolver(new XmlUrlResolver(), myPermissions);
   

   Dim myResolver As New XmlSecureResolver(New XmlUrlResolver(), myPermissions)
   

   Zie de XmlSecureResolver referentiepagina voor een ander voorbeeld.

Toegang beperken met behulp van bewijsmateriaal

U kunt de toegang beperken met behulp van de XmlSecureResolver(XmlResolver, Evidence) constructor en opgeven Evidence. De Evidence wordt gebruikt om de PermissionSet waarde te maken die wordt toegepast op de onderliggende XmlResolverwaarde. De XmlSecureResolver roept PermitOnly aan op de gemaakte PermissionSet voordat er middelen worden geopend.

Hier volgen enkele veelvoorkomende scenario's en het type bewijs dat voor elk van deze scenario's moet worden verstrekt:

• Als u in een volledig vertrouwde omgeving werkt, gebruikt u uw assembly om het bewijs te maken:

  Evidence myEvidence = this.GetType().Assembly.Evidence;
  XmlSecureResolver myResolver;
  myResolver = new XmlSecureResolver(new XmlUrlResolver(), myEvidence);
  

  Dim myEvidence As Evidence = Me.GetType().Assembly.Evidence
  Dim myResolver As XmlSecureResolver
  myResolver = New XmlSecureResolver(New XmlUrlResolver(), myEvidence)
  

• Als u in een semi-vertrouwde omgeving werkt, hebt u code of gegevens afkomstig van een externe bron en weet u de oorsprong van de externe bron en hebt u een verifieerbare URI, gebruikt u de URI om het bewijs te maken:

  
  Evidence myEvidence = XmlSecureResolver.CreateEvidenceForUrl(sourceURI);
  XmlSecureResolver myResolver = new XmlSecureResolver(new XmlUrlResolver(), myEvidence);
  

  Dim myEvidence As Evidence = XmlSecureResolver.CreateEvidenceForUrl(sourceURI)
  Dim myResolver As New XmlSecureResolver(New XmlUrlResolver(), myEvidence)
  

• Als u in een semi-vertrouwde omgeving werkt en u code of gegevens hebt die afkomstig zijn van een externe bron, maar u niet weet wat de oorsprong is van de externe bron:

  Stel de evidence parameter in op null. Hiermee is er geen toegang tot bronnen.

  – of –

  Als voor uw toepassing toegang tot resources is vereist, vraagt u bewijs aan bij de beller.

De beveiligde resolver gebruiken om een XSLT-opmaakmodel te laden

1. Maak een XmlSecureResolver met de juiste machtigingenset.

2. Geef de XmlSecureResolver methode door aan de Load methode.

   XslCompiledTransform xslt = new XslCompiledTransform();
   xslt.Load("http://serverName/data/xsl/sort.xsl", null, myResolver);
   

   Dim xslt As New XslCompiledTransform()
   xslt.Load("http://serverName/data/xsl/sort.xsl", Nothing, myResolver)