matt-lethargic/fusionauth-netcore-client

The .NET Core client for FusionAuth

FusionAuth .NET Core Client

If you're integrating FusionAuth with a .NET Core application, this library will speed up your development time.

Here's a small Example showing how to use this client: Example.cs

For additional information and documentation on FusionAuth refer to https://fusionauth.io.

https://www.nuget.org/packages/FusionAuth.Client/

Refer to the FusionAuth API documentation for request and response formats.

• https://fusionauth.io/docs/v1/tech/apis/
• https://fusionauth.io/docs/v1/tech/client-libraries/netcore

Supported Frameworks

• .NET Standard 2.0, 2.1
• .NET Core 2.1, 3.1
• .NET 5
• .NET 6
• .NET 7 (tested with rc.1)

Tests

There are some tests. Most require a running FusionAuth instance.

To run them:

• cd fusionauth-netcore-client-test/fusionauth-netcore-client-test
• dotnet build && dotnet test # or, to run only a few
• dotnet build && dotnet test --filter CorrectlyD

Testing locally

If you want to test a build of this library locally, you can use this answer from SO after compiling it.

Pull this repo and update usermanager.csproj. Replace <PackageReference Include="FusionAuth.Client" Version="1.42.0" /> with a path to your complied .csproj file.

Here's what my usermanager.csproj <ItemGroup> looked like during testing:

<ItemGroup>
  <ProjectReference Include="/path/to/fusionauth-netcore-client/fusionauth-netcore-client/fusionauth-netcore-client.csproj" />
  <PackageReference Include="JSON.Net" Version="1.0.18" />
</ItemGroup>

Questions and support

If you have a question or support issue regarding this client library, we'd love to hear from you.

If you have a paid edition with support included, please open a ticket in your account portal. Learn more about paid editions here.

Otherwise, please post your question in the community forum.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/FusionAuth/fusionauth-netcore-client.

If you find an issue with syntax, etc - this is likely a bug in the template. Feel free to submit a PR against the Client Builder project.

• Client Builder
• netcore.client.interface.ftl
• netcore.client.ftl
• netcore.client.sync.ftl
• netcore.domain.ftl

License

The code is available as open source under the terms of the Apache v2.0 License.

Upgrade Policy

This library is built automatically to keep track of the FusionAuth API, and may also receive updates with bug fixes, security patches, tests, code samples, or documentation changes.

These releases may also update dependencies, language engines, and operating systems, as we'll follow the deprecation and sunsetting policies of the underlying technologies that it uses.

This means that after a dependency (e.g. language, framework, or operating system) is deprecated by its maintainer, this library will also be deprecated by us, and will eventually be updated to use a newer version.