Esri Maps for SharePoint

Konfigurere en proxy

I den Silverlight-baserte ArcGIS Map-webdelen kan du bruke en proxyside for å få tilgang til ArcGIS Server-tjenester som er sikret med tokenbasert godkjenning. En proxyside består av kode på serversiden som kjører på webserveren. Forespørselen sendes via webleseren til proxyen, og så videresendes forespørselen fra proxyen til ArcGIS Server-tjenesten.Esri Maps for SharePoint tilbyr en proxyside, Proxy.ashx, som du kan bruke til å håndtere kommunikasjon med ArcGIS Server-tjenester som brukes i programmet ditt. Nedlasting Proxy.zip.

Proxy.ashx-siden sender HTTP-referenten videre fra programmene til serveren. Normalt trenger du én proxyside per program hvis du bruker tokener, fordi tokener er programspesifikke. Omfanget du bør velge å definere tokener for (område, side og så videre), avhenger av hvilket nivå du vil godkjenne på. Hvis alle Map-webdelene på et helt område forbruker sikrede ArcGIS Server-tjenester på samme måte, kan det være fornuftig å definere én proxy for området. Hvis ulike Map-webdeler på et område ikke har tilgang til sikrede tjenester på samme måte, bør du sette opp en proxy for hver side eller for et sett med sider som bruker samme tillatelser.

Når du henter tokener fra Services Directory (for eksempel http://<servernavn>/ArcGIS/tokens/gettoken.html), bruker du hele URL-en til SharePoint-området eller -siden i stedet for bare http://<vertsnavn>. I Proxy.config-filen limer du inn hele tokenen uten mellomrom foran eller etter den. Du finner detaljerte instruksjoner i neste avsnitt.

Laste ned og konfigurere proxysiden

Den følgende fremgangsmåten viser hvordan du laster ned og installerer proxysiden på webserveren din. Proxysiden kjører på den lokale webserveren din, ikke på en Esri-server eller på ArcGIS Server-datamaskinen (med mindre webserveren også er vert for ArcGIS Server-forekomsten). Proxysiden trenger ikke befinne seg på SharePoint-serveren.

Før du går videre, bør du kontrollere at du har ASP.NET 2.0 eller høyere installert og registrert med IIS. Hvis ASP.NET ikke er konfigurert med IIS, følger du instruksjonene for den versjonen av IIS du kjører, i hjelpeemnet ASP.NET and IIS Configuration på MSDN.

  1. Nedlasting Proxy.zipDeretter pakker du ut filen og lagrer innholdet i en mappe i webserverens rotkatalog. I IIS er standardplasseringen for webserverens rotkatalog c:\inetpub\wwwroot. Hvis du planlegger å bruke proxyen for flere områder, kan du opprette en mappe med navn proxy i webserverens rotkatalog og plassere innholdet der.
  2. Åpne IIS-behandling. Se How to: Open IIS Manager hvis du vil ha mer informasjon om hvordan du åpner IIS-behandling med den versjonen av IIS du bruker.
  3. Opprett et webprogram for proxymappen. Denne fremgangsmåten er annerledes avhengig av hvilken versjon av IIS du bruker.
  4. For IIS 5 eller 6 følger du denne fremgangsmåten:
    1. I Default Web Site høyreklikker du på proxykatalogen og klikker på Egenskaper.
    2. I kategorien Mappe i delen Applikasjonsinnstillinger klikker du på Opprett-knappen og deretter på OK.
      Opprette IIS-program
  5. For IIS 7 følger du denne fremgangsmåten. Du finner mer informasjon i Create a Website (IIS 7).
    1. I Default Web Site høyreklikker du på Proxy-katalogen og klikker på Legg til applikasjon.
      Opprette IIS 7-program
    2. Angi Alias og Fysisk bane i dialogboksen Legg til applikasjon, og klikk på OK.
      Legge til IIS 7-program
  6. Hent en token for tjenesten. Hvis programmet bruker flere ArcGIS Server-systemer som krever token, henter du en token for hver server. Du finner mer informasjon om hvordan du henter en token, i Acquiring ArcGIS Tokens.
  7. Åpne proxysiden for konfigurasjon (proxy.config) i et tekst- eller XML-redigeringsprogram.
  8. Legg til en <serverUrl>-oppføring i XML-filen for konfigurasjon i <serverUrls>-delen for hver ArcGIS-server som skal bruke proxysiden. Se konfigurasjonsfilen for proxyen hvis du vil se eksempler. serverUrl-elementet kan ha følgende attributter:
    • url – URL-en til ArcGIS Server-maskinen eller -tjenesten. Hvis flere tjenester på samme server brukes i programmet, kan url-attributtet peke til tjenesteroten. Hvis det bare er én tjeneste på serveren som brukes, kan url-attributtet settes til hele tjeneste-URL-en.
    • matchAll – Angir hvorvidt tokenen skal brukes til alle forespørsler med denne URL-stammen. Hvis dette attributtet er satt til True og url-attributtet er satt til tjenesteroten, kan oppføringen brukes til flere tjenester i programmet.
    • token – Godkjenningstoken hentet i trinn 1. Optional – Brukes bare til tjenester som er sikret med tokenbasert godkjenning.

    Hvis flere tjenester på samme server brukes i programmet, kan URL-en peke til tjenesteroten (for eksempel http://www.example.com/arcgis/rest/services), og matchAll-parameteren kan settes til True. Du kan legge til flere serveroppføringer hvis mer enn én ArcGIS Server-datamaskin brukes i programmet.

    mustMatch-attributtet i innholdselementet kontrollerer hvorvidt det bare er mulig å bruke en proxy for angitte områder. Dette attributtet skal vanligvis settes til true. Hvis det settes til false, videresender proxysiden en hvilken som helst forespørsel til en hvilken som helst server. Dette kan potensielt føre til at proxysiden din kan brukes til å sende forespørsler til tredjepartsservere uten tillatelse fra deg.

  9. Lagre konfigurasjonsfilen. Noter deg URL-en til proxysiden, ettersom du trenger den når du skal legge til en sikret karttjeneste i Esri Maps for SharePoint.

Når du har konfigurert proxysiden med programmet, tester du programmet for å sikre at forespørsler blir behandlet på riktig måte. Programmet skal fungere som normalt slik det gjorde før proxysiden ble implementert. Hvis ikke kan det hende du må feilsøke proxyen. Hvis programmiljøet ditt støtter feilsøkingsmodus, kan det hende du kan angi et stoppunkt på proxysiden og finne ut om programmet fungerer som det skal.