https://andrewlock.net/how-to-use-the-ioptions-pattern-for-configuration-in-asp-net-core-rc2/
https://andrewlock.net/reloading-strongly-typed-options-in-asp-net-core-1-1-0/

update documentation on:

Running under the full IIS

dotnet/AspNetCore.Docs#1982 (comment)
https://docs.asp.net/en/latest/publishing/iis.html
https://msdn.microsoft.com/magazine/mt736459
aspnet/Announcements#172
https://www.strathweb.com/2015/12/running-asp-net-5-website-on-iis/

HTTPs

https://blogs.msdn.microsoft.com/webdev/2017/11/29/configuring-https-in-asp-net-core-across-different-platforms/

Dotnet CLI (dotnet run)

• make it run without exceptions - needs to refine loading of configuration
  testing tip: use Debugger.Launch();
• http://stackoverflow.com/questions/37322565/dotnet-run-or-dotnet-watch-with-development-environment-from-command-line

https://wopirest.readthedocs.io/en/latest/endpoints.html?highlight=locks

http://wopi.readthedocs.io/projects/wopirest/en/latest/ecosystem/CheckEcosystem.html

I am trying to open the docx file but I am not able to render it

http://ussecvmfsu3j9.ey.net:8080/wv/wordviewerframe.aspx?WOPISrc=http%3a%2f%2fussecvmfsu3j9.ey.net%3a8080%2fapi%2fwopi%2ffiles%2ftest.docx&access_token=8OH4q2yWjZM%3dzfE7tZ94cGYRWC%2bDCUYrwJpg6FodQtXVluxjRVoFTLs%3d

and the window with word online keeps loading

Can anybody suggest me how to make it render on browser?

Thanks in advance

I am getting this error when I was trying to open the edit url
by the next url

http://owas.cmsad.local/we/wordeditorframe.aspx?WOPISrc=http%3a%2f%2fowas.cmsad.local%2fhosting%2fdocs%2ftest.docx&access_token=IXuJCdjmmhc%3dHfPAmKzzT%2bs7zJpT4czLS4SVv1kBeGsIpbtJxaq%2f6mQ%3d&ui=zh-CN

Exception WAC Server FrontEnd unhandled exception [0] Microsoft.Office.Web.Common.EnvironmentAdapters.FileUnknownException: required URL paramters are not present at Microsoft.Office.Web.Apps.Common.WopiDocument.CreateFromQuerySignature(String querySignature) at Microsoft.Office.Web.Apps.Environment.WacServer.WSMainStorage.GetBaseDocumentFromContext(HttpContext context, String rawHostDocumentId) at Microsoft.Office.Web.Host.WacServer.WebOneNote.WoncaFrame.OnPreRender(EventArgs e) at Microsoft.Office.Web.Host.WacServer.WebOneNote.WordEditorFrame.OnPreRender(EventArgs e) at System.Web.UI.Control.PreRenderRecursiveInternal() at System.Web.UI.Page.ProcessRequestMain(Boolean includeStagesBeforeAsyncPoint, Boolean includeStagesAfterAsyncPoint) StackTrace: at uls.native.dll: (sig=2... 6b5565bf-0574-4f6e-8c6c-f9d0c1549913

There is no tracing/debug info logging yet.
https://msdn.microsoft.com/magazine/mt694089?MC=.NET

https://wopi.readthedocs.org/en/latest/troubleshooting.html#correlation-ids
Consider using:

• Serilog
• or Microsoft.AspNet.Diagnostics

• upgrade to netcore/netstandard 2.0
• notify reporters
• Complete migration guide https://docs.microsoft.com/en-us/aspnet/core/migration/22-to-30?view=aspnetcore-3.0&tabs=visual-studio#migrate-libraries-via-multi-targeting

1.1

• aspnet/DotNetTools#169 (comment)

2.0

• aspnet/Announcements#209
• aspnet/Announcements#212
• aspnet/Announcements#223
• aspnet/Announcements#232
• aspnet/Announcements#262 (Solved AutomaticAuthenticate according to:)

2.2

• aspnet/Announcements#307

3.0

• some extra info: https://medium.com/@zarkopafilis/asp-net-core-2-2-3-rest-api-16-migrating-to-net-core-3-4b8a34852b40

Multiple configs - http://docs.asp.net/en/latest/fundamentals/environments.html
User secrets - https://github.com/aspnet/Home/wiki/DNX-Secret-Configuration
SO Discussion - http://stackoverflow.com/questions/28258227/how-to-set-ihostingenvironment-environmentname-in-vnext-application

make the wopihostoptions more structured

plus, implement the ioptionssnapshot for wopihost.web

C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.CobaltCore\v4.0_16.0.0.0__71e9bce111e9429c

Inspiration:

• http://stackoverflow.com/questions/39302121/header-based-routing-in-asp-net-core
• http://weblogs.asp.net/jongalloway//looking-at-asp-net-mvc-5-1-and-web-api-2-1-part-2-attribute-routing-with-custom-constraints
• http://blogs.msdn.com/b/webdev/archive/2013/10/17/attribute-routing-in-asp-net-mvc-5.aspx
• https://artokai.wordpress.com/2013/10/04/asp-net-mvc-header-based-routing/
• https://artokai.wordpress.com/2013/10/
• http://stackoverflow.com/questions/12344522/how-to-append-a-prefix-to-action-name-according-to-a-particular-route

waiting for: http://help.appveyor.com/discussions/problems/1235-uploading-fixie-testresults-as-nunit-or-xunit-gives-500-error

blocker: appveyor/ci#610

tests are currently turned off

docu:
http://www.appveyor.com/docs/appveyor-yml
http://www.appveyor.com/docs/build-worker-api#add-tests
http://www.appveyor.com/docs/running-tests#xunit-c
https://docs.asp.net/en/latest/testing/integration-testing.html <- testserver?

xunit docu:
https://xunit.github.io/docs/getting-started-dnx.html

other resources:
http://blogs.msdn.com/b/webdev/archive/2015/08/06/unit-testing-with-dnx-asp-net-5-projects.aspx
https://fluentbytes.com/running-xunit-test-with-asp-net-dnx-and-tfs-2015-build/

seems it's two separate endpoints, more info here: http://slideplayer.com/slide/10861664/ (slide 18+)

currently ContainersController contains implementation for what should be FoldersController...this needs to be corrected

Folders spec:
https://wopirest.readthedocs.io/en/latest/files/CheckFileInfo.html#term-supportsfolders
https://msdn.microsoft.com/en-us/library/hh642840(v=office.12).aspx

• params: https://msdn.microsoft.com/en-us/library/hh642805(v=office.12).aspx

Containers spec:
http://wopi.readthedocs.io/projects/wopirest/en/latest/containers/CheckContainerInfo.html

Set up on of the following:

• https://codecov.io/
• https://coveralls.io/
• https://scan.coverity.com/
• https://sonarqube.com/about

1. Download OpenCover
2. Run OpenCover
3. Upload OpenCover's results

running opencover with .net core:

• official example: https://github.com/codecov/example-csharp

example of opencover with dotnet cli:
http://stackoverflow.com/questions/36460254/vs2015-code-coverage-not-working-with-tests-in-asp-net-core-1-0-formerly-known

working code:
OpenCover.Console.exe -target:"C:\Program Files\dotnet\dotnet.exe" -targetargs:" test ""C:\Users\petrs\Documents\GitHub\WopiHost\WopiHost.FileSystemProvider.Tests\project.json"" -f netcoreapp1.0 -xml ""C:\Users\petrs\Documents\GitHub\WopiHost\WopiHost.FileSystemProvider.Tests\xunit-results.xml"" -nologo -parallel none" -output:"C:\Users\petrs\Documents\GitHub\WopiHost\coverage.xml" -register:user -filter:"+[*]* -[xunit*]* -[*]*Migrations.*" -returntargetcode -oldstyle

-oldstyle argument required until OpenCover/opencover#595 gets implemented

another example that should work:
c:\Users\tmds\AppData\Local\Apps\OpenCover\OpenCover.Console.exe "-target:C:\Program Files\dotnet\dotnet.exe" -targetargs:test -register:user -filter:"+[*]* -[xunit*]*" -output:coverage.xml -oldStyle

opencover+appveyor example:
https://github.com/jwaliszko/ExpressiveAnnotations

other resources:
https://github.com/OpenCover/opencover/wiki/DNX-Support
http://blog.stephencleary.com/2015/03/continuous-integration-code-coverage-open-source-net-coreclr-projects.html
http://dotnetthoughts.net/measuring-code-coverage-of-aspnet-core-applications-using-opencover/
http://help.appveyor.com/discussions/problems/4394-problem-with-args-to-xunit-in-powershell
OpenCover/opencover#327

Full YMLs:

• https://anotherlookontech.wordpress.com/2016/10/12/integrate-net-core-appveyor-opencover-and-codecov/
  -- https://github.com/joaoasrosa/unittestsexternalsources/blob/master/appveyor.yml
• https://blog.markvincze.com/setting-up-coveralls-for-a-net-core-project/
  -- https://github.com/markvincze/Stubbery/blob/master/coverage.sh
• http://blog.stephencleary.com/2015/03/continuous-integration-code-coverage-open-source-net-coreclr-projects.html

This is a proper way of getting app directory:
aspnet/Announcements#17 (comment)

Look at how the DLLs are loaded...

https://msdn.microsoft.com/magazine/mt707534?MC=.NET&MC=ASPNET&MC=CSHARP

• perhaps get rid of autofac and use the stock container (done for wopihost.web)

Hi petrsvihlik, my issue is rather related to a general problem then to your source code, I am sorry if you didn't like me raising this question as an issue. I found you most active on WOPI platform.

I have implemented the WOPI Host and client on Windows Server 2012 RC, I can access the discovery url but when I am trying to open a office file on the browser, the file is not getting load.

I can see the logs of WOPI Host but how can I see the WOPI Client error logs ? when I further investigated I found in the IIS Administrator tools under event viewer there are lots of error logs related to Office Web Apps Server and all are showing "Reported Status :Machine Health is UnHealthy".

Please let me know if you have any idea on this issue.

Accordingly to: https://msdn.microsoft.com/en-us/library/hh657364(v=office.12).aspx

https://www.youtube.com/watch?v=Vc4nBxcVe7I

aspnet/Announcements#98 -> for tests
aspnet/Announcements#105
aspnet/Announcements#106
aspnet/Announcements#108
aspnet/Announcements#118
aspnet/Announcements#120
aspnet/Announcements#121
aspnet/Announcements#125
aspnet/Announcements#131
aspnet/Announcements#132
aspnet/Announcements#137
aspnet/Announcements#139
aspnet/Announcements#141
aspnet/Announcements#143
aspnet/Announcements#144
aspnet/Announcements#148
aspnet/Announcements#149
aspnet/Announcements#153
aspnet/Announcements#154
aspnet/Announcements#156
aspnet/Announcements#157
aspnet/Announcements#164
aspnet/Announcements#166
aspnet/Announcements#168
aspnet/Announcements#169
aspnet/Announcements#171
aspnet/Announcements#172
aspnet/Announcements#173
aspnet/Announcements#174
aspnet/Announcements#175
aspnet/Announcements#176
aspnet/Announcements#177
aspnet/Announcements#180

[CI] Branch protection:
A single continuous-integration/appveyor GitHub commit status was replaces with two separate statuses: continuous-integration/appveyor/branch and continuous-integration/appveyor/pr for regular "push" and PR builds respectively.
If you have protected GitHub branches checking AppVeyor status please update them now to use new continuous-integration/appveyor/pr status.

Spec: http://wopi.readthedocs.io/en/latest/hostpage.html
Example: https://github.com/OfficeDev/PnP-WOPI/blob/master/com.microsoft.dx.officewopi/Controllers/HomeController.cs
https://github.com/OfficeDev/PnP-WOPI/blob/master/com.microsoft.dx.officewopi/Views/Home/Detail.cshtml

Remove workaround in appveyor.yml after this is fixed: NuGet/Home#1227

• About
• Download
• Installation/deployment
• Windows PowerShell for Office Web Apps Server

perhaps a Kentico Connector?

http://wopi.readthedocs.org/en/latest/intro.html
https://github.com/Microsoft/Office-Online-Test-Tools-and-Documentation/blob/master/samples/SampleWopiHandler/SampleWopiHandler/WopiHandler.cs

wopidiscovery: https://wopi.readthedocs.org/en/latest/discovery.html?highlight=url
wopiserver: https://onenote.officeapps.live.com/hosting/discovery

nuget sources:
https://nuget.codeplex.com/SourceControl/network/forks/einaregilsson/NuGet/contribution/5893#!/tab/changes

cobalt licensing: http://blogs.technet.com/b/volume-licensing/archive/2013/05/22/how-to-license-office-web-apps-server.aspx

publish to azure: aspnet/dnx#2467 (comment)

http://wopi.readthedocs.io/projects/wopirest/en/latest/bootstrapper/Bootstrap.html

resources:

• https://stormpath.com/blog/token-authentication-asp-net-core

• http://andrewlock.net/a-look-behind-the-jwt-bearer-authentication-middleware-in-asp-net-core/

• https://goblincoding.com/2016/07/03/issuing-and-authenticating-jwt-tokens-in-asp-net-core-webapi-part-i/

• https://github.com/blowdart/AspNetAuthorizationWorkshop

• https://docs.asp.net/en/latest/security/authorization/resourcebased.html

• https://docs.asp.net/en/latest/security/authorization/policies.html

• https://blogs.msdn.microsoft.com/webdev/2016/03/15/get-started-with-asp-net-core-authorization-part-1-of-2/

• 2 ASP.NET Core and User Authentication.pdf

• use identityserver? https://identityserver.github.io/Documentation/docs/overview/simplestOAuth.html

• https://github.com/SiroccoHub/JwtCore

Specification: https://msdn.microsoft.com/en-us/library/hh623363(v=office.12).aspx

Then answer http://stackoverflow.com/questions/25875427/when-the-file-should-be-unlocked-at-wopi-server-side-after-file-is-locked-for-ed

http://wopi.readthedocs.io/projects/wopirest/en/latest/concepts.html#lock-length

needs to be scripted before this gets implemented:
appveyor/ci#610

follow up to: #23

According to aspnet/Announcements#49

waiting for this to be resolved:
https://github.com/dotnet/corefx/issues/11100

• https://github.com/dotnet/corefx/issues/15031
• https://github.com/dotnet/corefx/issues/9846

workaround:

<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="System.Net.Http" publicKeyToken="b03f5f7f11d50a3a" culture="neutral"/>
        <bindingRedirect oldVersion="4.1.1.0" newVersion="4.0.0.0"/>
      </dependentAssembly>
</assemblyBinding>
  </runtime>
</configuration>

To make it lightweight, MVC should be replaced with MVC.Core (views are not needed for web api).

Resources:
https://offering.solutions/blog/articles/2017/02/07/difference-between-addmvc-addmvcore/

Accordingly to MS-FSSHTTP

Specification:
http://wopi.readthedocs.io/en/latest/scenarios/coauth.html
https://msdn.microsoft.com/en-us/library/hh622920(v=office.12).aspx

Per their clarification, MS-FSSHTTP is required for Word editing of any kind; Locks are not enough.

npm had problems with dependencies and packaging lately...this needs to be fixed

package.json dependencies: http://stackoverflow.com/questions/18875674/whats-the-difference-between-dependencies-devdependencies-and-peerdependencies
Pipeline: https://www.appveyor.com/docs/build-configuration#build-pipeline

https://learn.microsoft.com/en-us/microsoft-365/cloud-storage-partner-program/rest/files/putrelativefile

https://blogs.msdn.microsoft.com/cesardelatorre/2016/06/28/running-net-core-apps-on-multiple-frameworks-and-what-the-target-framework-monikers-tfms-are-about/

Specification:
https://wopi.readthedocs.org/en/latest/scenarios/createnew.html
https://msdn.microsoft.com/en-us/library/hh695196(v=office.12).aspx

https://www.appveyor.com/docs/deployment/web-deploy

possibly using https://www.visualstudio.com/app-center/pricing/

aspnet/Announcements#77 ✅
aspnet/Announcements#80 ✅
aspnet/Announcements#91 ✅
aspnet/Announcements#93 ✅
aspnet/Announcements#97 ✅
aspnet/Announcements#98 ✅
aspnet/Announcements#104 ✅
aspnet/Announcements#113 ✅
aspnet/Announcements#116 (aspnet/Announcements#64 (comment)) ✅

appveyor
A single continuous-integration/appveyor GitHub commit status was replaces with two separate statuses: continuous-integration/appveyor/branch and continuous-integration/appveyor/pr for regular "push" and PR builds respectively.
If you have protected GitHub branches checking AppVeyor status please update them now to use new continuous-integration/appveyor/pr status.

Use:
Configuration.GetValue<bool>("xyz",default(bool)) instead of Configuration.GetSection("xyz").Value

See:
https://blogs.msdn.microsoft.com/cjaliaga/2016/08/10/working-with-azure-app-services-application-settings-and-connection-strings-in-asp-net-core/

--> update keys in azure

FilesController shouldn't reference Cobalt.

aspnet/Announcements#61
aspnet/Announcements#62
aspnet/Announcements#63
aspnet/Announcements#64 (use secret manager for user-specific settings)
aspnet/Announcements#69 (update the IIS hosting example in documentation)
aspnet/Announcements#77
aspnet/Announcements#80

http://blogs.msdn.com/b/webdev/archive/2015/10/15/announcing-availability-of-asp-net-5-beta8.aspx

Documentation says " you don’t have to implement the [MS-FSSHTTP]: File Synchronization via SOAP over HTTP Protocol (Cobalt)"

• discovery indicates the same
  => cobalt should be made an optional module

http://blogs.technet.com/b/volume-licensing/archive/2013/05/22/how-to-license-office-web-apps-server.aspx

using a decorator perhaps?
http://docs.autofac.org/en/latest/advanced/adapters-decorators.html

• fix as suggested in http://help.appveyor.com/discussions/problems/2876-nuget-restore-fails-from-all-of-a-sudden
• update the post
• submit a new issue to github repo (and/or fix it)

Dependent on:
appveyor/ci#397
NuGet/Home#1227 (comment)

First of all, very nice. Thank you so much. Your project is very helpful for me.

I see that you have the client discovery XML for Office Online inside your discovery tests and you're probably using your FileSystemDiscoveryProvider (or some such) to load the downloaded file.

But if I need to use your HttpDiscoveryProvider to get the XML from the Web, at what URL may I find the client discovery XML file for Office Online?

You may answer the question here or on StackOverflow or both.

My question is: https://stackoverflow.com/questions/45429487/from-where-may-i-get-the-wopi-client-discovery-xml-for-the-wopi-client-office-on

Permalink: https://stackoverflow.com/q/45429487/303685

Once more, thanks for such a wonderful effort.

Have you ever met this issue?
Excel can be viewed and edited. Word can't (not all files, some can be viewed )， all of them are editable though.I'm wondering if this bug was caused by oos server?

get rid of the session management...all should be stateless

Hello,

Thanks for the great sample. WIll this run on Linux and .Net Core? If yes which version of .Net Core would you suggest I try to play around?

Thanks,
G

I'm run your project in my PC very well, but WopiHost show message like this:
fail: Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware[0]
An unhandled exception has occurred while executing the request
System.FormatException: The input is not a valid Base-64 string as it contains a
non-base 64 character, more than two padding characters, or an illegal characte
r among the padding characters.
at System.Convert.FromBase64_Decode(Char* startInputPtr, Int32 inputLength, B
yte* startDestPtr, Int32 destLength)
at System.Convert.FromBase64CharPtr(Char* inputPtr, Int32 inputLength)
at System.Convert.FromBase64String(String s)
at WopiHost.FileSystemProvider.WopiFileSystemProvider.DecodeIdentifier(String
identifier) in D:\WopiHost-master(4)\WopiHost-master\WopiHost.FileSystemProvide
r\WopiFileSystemProvider.cs:line 97
at WopiHost.FileSystemProvider.WopiFileSystemProvider.GetWopiFile(String iden
tifier) in D:\WopiHost-master(4)\WopiHost-master\WopiHost.FileSystemProvider\Wop
iFileSystemProvider.cs:line 47
at WopiHost.Core.Controllers.FilesController.d__11.MoveNext
() in D:\WopiHost-master(4)\WopiHost-master\WopiHost.Core\Controllers\FilesContr
oller.cs:line 64
--- End of stack trace from previous location where exception was thrown ---
at System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNot
ification(Task task)
at Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker.d__27.MoveNext()
--- End of stack trace from previous location where exception was thrown ---
at System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNot
ification(Task task)
at Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker.d__25.MoveNext()
--- End of stack trace from previous location where exception was thrown ---
at Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker.Rethrow(ActionEx
ecutedContext context)
at Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker.Next(State& next
, Scope& scope, Object& state, Boolean& isCompleted)
at Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker.d__
20.MoveNext()
--- End of stack trace from previous location where exception was thrown ---
at System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNot
ification(Task task)
at Microsoft.AspNetCore.Builder.RouterMiddleware.d__4.MoveNext()
--- End of stack trace from previous location where exception was thrown ---
at System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNot
ification(Task task)
at Microsoft.AspNetCore.Authentication.AuthenticationMiddleware1.<Invoke>d__ 18.MoveNext() --- End of stack trace from previous location where exception was thrown --- at Microsoft.AspNetCore.Authentication.AuthenticationMiddleware1.d__
18.MoveNext()
--- End of stack trace from previous location where exception was thrown ---
at System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNot
ification(Task task)
at Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware.
d__7.MoveNext()
info: Microsoft.AspNetCore.Hosting.Internal.WebHost[2]
Request finished in 1040.8624ms 500 text/html; charset=utf-8

It may possibly cannot support file with chinese character filename ???
i have file named chinese character filename in wopi-docs.

How to support chinese character filename ?

for example,the docx file limit is 50MB.

I'm so sorry that my Enlish is poor.

Thank you.

aspnet/Announcements#51 -> FIXED
aspnet/Announcements#52 -> FIXED
aspnet/Announcements#53 -> N/A
aspnet/Announcements#54 -> N/A
aspnet/Announcements#55 -> FIXED

aspnet/Announcements#178 ✔️
aspnet/Announcements#181 ✔️
aspnet/Announcements#182 ✔️
aspnet/Announcements#184 ✔️
aspnet/Announcements#185 ✔️
aspnet/Announcements#187 ✔️

TO VERIFY: aspnet/Announcements#194 ✔️

https://docs.asp.net/en/latest/migration/rc1-to-rtm.html
https://docs.microsoft.com/en-us/dotnet/articles/core/tools/project-json

commented out in:
https://github.com/petrsvihlik/WopiHost/blob/master/appveyor.yml

OpenCover/opencover#601 (comment)

Resources:

• http://foreverframe.net/integrating-codecov-with-net-core-app-appveyor-and-github/
• https://www.appveyor.com/blog/2017/03/17/codecov/
• https://joaorosa.io/2016/10/12/integrate-net-core-appveyor-opencover-and-codecov/