This repository contains the code for the web services backing the AAS WorldWide Telescope (WWT) software system.

Note The contents of this repository are in flux as we modernize this codebase.

To be revised. Some old notes are in INSTALL.md.

This project is configured to use Azurite, a cross-platform emulator for Azure storage. There are multiple ways to acquire the tool, so please refer to the link given to set up an install.

Access to the storage is done via the DefaultAzureTokenCredential that requires https protocol for connection. In order to do that, the following steps must be done to enable development:

These are steps taken from here:

1. Install mkcert

2. Trust the mkcert RootCA.pem and create a certificate

   mkcert -install
   mkcert 127.0.0.1
   

3. Chose a directory from which to run Azurite. The local emulator data will be stored here

4. Run Azurite with oauth and SSL support:

   azurite --oauth basic --cert 127.0.0.1.pem --key 127.0.0.1-key.pem
   

5. The app will now run with default settings.

In order to configure the Azure Storage Explorer to run, you'll need to do the following:

1. Get the RootCA.pem

   mkcert -CAROOT
   

2. Open Azure Storage Explorer

3. Go to Edit->SSL Certificates->Import Certificates and select the file from the first step.

4. Restart the storage explorer (you will be prompted to do this)

Configuration in this project uses ConfigurationManager.AppSettings. In order to make it easier to configure outside of web.config, ConfigurationBuilders are supported. Currently, there are three builders enabled: KeyVault, Environment, and User Secrets. For more details, see the project where they are maintained.

We love it when people get involved in the WWT community! You can get started by participating in our user forum or by signing up for our low-traffic newsletter. If you would like to help make WWT better, our Contributor Hub aims to be your one-stop shop for information about how to contribute to the project, with the Contributors’ Guide being the first thing you should read. Here on GitHub we operate with a standard fork-and-pull model.

All participation in WWT communities is conditioned on your adherence to the WWT Code of Conduct, which basically says that you should not be a jerk.

The AAS WorldWide Telescope system is a .NET Foundation project. Work on WWT has been supported by the American Astronomical Society (AAS), the US National Science Foundation (grants 1550701, 1642446, and 2004840), the Gordon and Betty Moore Foundation, and Microsoft.

The WWT code is licensed under the MIT License. The copyright to the code is owned by the .NET Foundation.