Problem med server- och klientkonfiguration i ClickOnce-distributioner

Om du använder Internet Information Services (IIS) på Windows Server och distributionen innehåller en filtyp som Windows inte känner igen, till exempel en Microsoft Word-fil, vägrar IIS att överföra filen och distributionen lyckas inte.

Dessutom innehåller vissa webbservrar och webbprogramprogram, till exempel ASP.NET, en lista över filer och filtyper som du inte kan ladda ned. Till exempel förhindrar ASP.NET nedladdning av alla Web.config filer. Dessa filer kan innehålla känslig information, till exempel användarnamn och lösenord.

Även om den här begränsningen inte bör orsaka några problem med att ladda ned grundläggande ClickOnce-filer, till exempel manifest och sammansättningar, kan den här begränsningen hindra dig från att ladda ned datafiler som ingår i ditt ClickOnce-program. I ASP.NET kan du lösa det här felet genom att ta bort hanteraren som förbjuder nedladdning av sådana filer från IIS-konfigurationshanteraren. Mer information finns i IIS-serverdokumentationen.

Vissa webbservrar kan blockera filer med tillägg som .dll, .configoch .mdf. Windows-baserade program innehåller vanligtvis filer med några av dessa tillägg. Om en användare försöker köra ett ClickOnce-program som kommer åt en blockerad fil på en webbserver resulterar ett fel. I stället för att avblockera alla filnamnstillägg publicerar ClickOnce alla programfiler med filtillägget .deploy som standard. Därför behöver administratören bara konfigurera webbservern för att avblockera följande tre filnamnstillägg:

• .applikation

• .manifest

• .gruppera

  Du kan dock inaktivera det här alternativet genom att avmarkera alternativet Använd filnamnstillägget ".deploy" i dialogrutan Publicera alternativ. I så fall måste du konfigurera webbservern för att avblockera alla filnamnstillägg som används i programmet.

Du måste konfigurera .manifest, .application och .deploy, till exempel om du använder IIS där du inte har installerat .NET Framework eller om du använder en annan webbserver (till exempel Apache).

ClickOnce och Secure Sockets Layer (SSL)

Ett ClickOnce-program fungerar bra jämfört med SSL, förutom när webbläsaren frågar om SSL-certifikatet. Uppmaningen kan aktiveras när det är något fel med certifikatet, till exempel när platsnamnen inte matchar eller om certifikatet har upphört att gälla. Om du vill att ClickOnce ska fungera via en SSL-anslutning kontrollerar du att certifikatet är up-to-date och att certifikatdata matchar platsdata.

ClickOnce och proxyautentisering

ClickOnce har stöd för Windows-integrerad proxyautentisering med start i .NET Framework 3.5. Det krävs inga specifika machine.config direktiv. ClickOnce har inte stöd för andra autentiseringsprotokoll, till exempel Basic eller Digest.

Du kan också använda en snabbkorrigering på .NET Framework 2.0 för att aktivera den här funktionen. Mer information finns i ÅTGÄRDA: Felmeddelande när du försöker installera ett ClickOnce-program som du skapade i .NET Framework 2.0 på en klientdator som är konfigurerad för att använda en proxyserver: "Proxyautentisering krävs".

Mer information finns i <defaultProxy-element> (nätverksinställningar).

ClickOnce- och webbläsarkompatibilitet

För närvarande startas ClickOnce-installationer endast om URL:en till distributionsmanifestet öppnas med hjälp av webbläsaren. En distribution vars URL startas från ett annat program, till exempel Microsoft Office Outlook, startas endast om Internet Explorer har angetts som standardwebbläsare.

Aktivera ClickOnce-program via webbläsarskript

Om du har utvecklat en anpassad webbsida som startar ett ClickOnce-program med active scripting kan det hända att programmet inte startas på vissa datorer. Webbläsaren innehåller en inställning, till exempel Automatisk fråga om filnedladdningar, vilket påverkar det här beteendet. Den här webbläsarinställningen visas vanligtvis under kategorin Nedladdningar och är aktiverad som standard. När den här inställningen är inaktiverad blockeras alla försök att aktivera ett ClickOnce-program programmatiskt (till exempel genom att tilldela dess URL till document.location egenskapen). Under dessa omständigheter kan användarna bara starta program via en användarinitierad nedladdning, till exempel genom att klicka på en hyperlänk inställd på programmets URL.

Ytterligare problem med serverkonfiguration

Administratörsbehörigheter krävs

Du måste ha administratörsbehörighet på målservern om du publicerar med HTTP. IIS kräver den här behörighetsnivån. Om du inte publicerar via HTTP behöver du bara skrivbehörighet på målsökvägen.

Problem med serverautentisering

När du publicerar till en fjärrserver som har "Anonym åtkomst" inaktiverad får du följande varning:

"The files could not be downloaded from http://<remoteserver>/<myapplication>/.  The remote server returned an error: (401) Unauthorized."

Använda webbservrar från tredje part

Om du distribuerar ett ClickOnce-program från en annan webbserver än IIS kan det uppstå ett problem om servern returnerar den felaktiga innehållstypen för viktiga ClickOnce-filer, till exempel distributionsmanifestet och programmanifestet. Lös problemet genom att läsa webbserverns hjälpdokumentation om hur du lägger till nya innehållstyper på servern och se till att alla mappningar för filnamnstillägget som anges i följande tabell finns på plats.

ClickOnce och mappade enheter

Om du använder Visual Studio för att publicera ett ClickOnce-program kan du inte ange en mappad enhet som installationsplats. Du kan dock ändra ClickOnce-programmet så att det installeras från en mappad enhet med hjälp av manifestgeneratorn och redigeraren (Mage.exe och MageUI.exe). Mer information finns i Mage.exe (manifestgenererings- och redigeringsverktyg) och MageUI.exe (manifestgenererings- och redigeringsverktyg, grafisk klient).

FTP-protokoll stöds inte för installation av program

ClickOnce stöder installation av program från en HTTP 1.1-webbserver eller filserver. FTP, File Transfer Protocol, stöds inte för att installera program. Du kan endast använda FTP för att publicera program. I följande tabell sammanfattas dessa skillnader:

Windows-brandväggen

Som standard aktiverar Windows Windows-brandväggen. Om du utvecklar ditt program på en dator som har Windows installerat kan du fortfarande publicera och köra ClickOnce-program från den lokala server som kör IIS. Du kan dock inte komma åt den server som kör IIS från en annan dator om du inte öppnar Windows-brandväggen. Mer information om hur du hanterar Windows-brandväggen finns i Windows-hjälpen.

Windows Server: Aktivera Servertillägg för FrontPage

FrontPage Server-tillägg från Microsoft krävs för publicering av program till en Windows-webbserver som använder HTTP.

Som standard har Windows Server inte FrontPage Server-tillägg installerade. Om du vill använda Visual Studio för att publicera till en Windows Server-webbserver som använder HTTP med FrontPage Server-tillägg måste du först installera Servertillägg för FrontPage. Du kan utföra installationen med hjälp av administrationsverktyget Hantera servern i Windows Server.

Windows Server: Låsta innehållstyper

IIS på Windows Server 2003 låser alla filtyper förutom vissa kända innehållstyper (till exempel .htm, .html, .txtoch så vidare). Om du vill aktivera distribution av ClickOnce-program med den här servern måste du ändra IIS-inställningarna så att filer av typen .application, .manifest och andra anpassade filtyper som används av ditt program kan laddas ned.

Om du distribuerar med en IIS-server kör duinetmgr.exe och lägger till nya filtyper för standardwebbsidan:

• För tilläggen .application och .manifest ska MIME-typen vara "application/x-ms-application". För andra filtyper ska MIME-typen vara "application/octet-stream".

• Om du skapar en MIME-typ med tillägget "<em>" och MIME-typen "application/octet-stream" kan filer av avblockerad filtyp laddas ned. (Det går dock inte att ladda ned blockerade filtyper som *.aspx och *.asmx .)

  Specifika anvisningar om hur du konfigurerar MIME-typer på Windows Server finns i Så här lägger du till en MIME-typ till en webbplats eller ett program.

Mappningar av innehållstyp

När du publicerar via HTTP ska innehållstypen (även kallad MIME-typ) för .application-filen vara "application/x-ms-application". Om du har .NET Framework 2.0 installerat på servern ställs detta in automatiskt. Om detta inte är installerat måste du skapa en MIME-typassociation för ClickOnce-programmet vroot (eller hela servern).

Om du distribuerar med en IIS-server kör du inetmgr.exe och lägg till en ny innehållstyp av "application/x-ms-application" för .application-tillägget .

PROBLEM med HTTP-komprimering

Med ClickOnce kan du utföra nedladdningar som använder HTTP-komprimering, en webbserverteknik som använder GZIP-algoritmen för att komprimera en dataström innan dataströmmen skickas till klienten. Klienten – i det här fallet ClickOnce – dekomprimerar strömmen innan den läser filerna.

Om du använder IIS kan du enkelt aktivera HTTP-komprimering. Men när du aktiverar HTTP-komprimering aktiveras den bara för vissa filtyper, nämligen HTML- och textfiler. Om du vill aktivera komprimering för sammansättningar (.dll), XML (.xml), distributionsmanifest (.application) och programmanifest (.manifest) måste du lägga till dessa filtyper i listan över typer som IIS ska komprimera. Tills du lägger till filtyperna i distributionen komprimeras endast text- och HTML-filer.

Detaljerade instruktioner för IIS finns i Så här anger du ytterligare dokumenttyper för HTTP-komprimering.

Relaterat innehåll

• Felsöka ClickOnce-distributioner
• Välj en ClickOnce-distributionsstrategi
• Krav för programdistribution