// This method gets called by the runtime. Use this method to add services to the container. public void ConfigureServices(IServiceCollection services) { services.AddControllersWithViews(); // In production, the Angular files will be served from this directory services.AddSpaStaticFiles(configuration => { configuration.RootPath = "ClientApp/dist"; }); // Define a named HttpClient that is configured to send requests to PAS (PrizmDoc Application Services). services.AddHttpClient("PAS", httpClient => PasUtil.ConfigureHttpClientForPas(httpClient, Configuration)); }
/// <summary> /// Asynchronously verifies this sample has been configured correctly to be able to send requests to PAS (PrizmDoc Application Services). See the README.md for more info. /// </summary> /// <param name="configuration">Application configuration instance</param> public static async Task ValidatePasConnectionAsync(IConfiguration configuration) { // This method tests creating a viewing session using the current application // configuration. If anything fails, we throw an exception with a helpful // error message so that, if you're just getting started with this sample, // you'll have some idea of what's wrong and what you should do to fix your // configuration to PAS (PrizmDoc Application Services). // // Don't be overwhelmed by the code in this method. // We're just trying to make your sample setup experience nice. // In a production application, you could remove all of this. if (configuration["PrizmDoc:PasBaseUrl"] == null) { throw new Exception("Missing required configuration setting \"PrizmDoc:PasBaseUrl\". See the README.md for more information."); } string defaultPasBaseUrl = "https://api.accusoft.com/prizmdoc/"; string defaultCloudApiKey = "YOUR_API_KEY"; string defaultPasSecretKey = null; var configurationHasNotYetBeenSet = configuration["PrizmDoc:PasBaseUrl"] == defaultPasBaseUrl && configuration["PrizmDoc:CloudApiKey"] == defaultCloudApiKey && configuration["PrizmDoc:PasSecretKey"] == defaultPasSecretKey; if (configurationHasNotYetBeenSet) { throw new Exception("It looks like you have not yet configured your connection to PAS (PrizmDoc Application Services). " + "See the README.md for more information."); } var pasHttpClient = PasUtil.CreatePasHttpClient(configuration); // Test POST /ViewingSession to see whether the configuration will work or not var response = await pasHttpClient.PostAsJsonAsync("ViewingSession", new { source = new { type = "upload", displayName = "test" } }); var json = await response.Content.ReadAsStringAsync(); string errorCode = null; if (!response.IsSuccessStatusCode) { // Parse the JSON errorCode, if present try { errorCode = (string)JObject.Parse(json)["errorCode"]; } catch (JsonReaderException) { // Ignore JSON parsing errors. errorCode will remain null. } } if (response.StatusCode == HttpStatusCode.Unauthorized && errorCode == "Unauthorized") { var valueSet = configuration["PrizmDoc:CloudApiKey"] != null; if (valueSet) { throw new Exception("Invalid API key. Make sure your \"PrizmDoc:CloudApiKey\" configuration value is correct. " + "See the README.md for more information."); } else { throw new Exception("Missing API key. Make sure you have provided a \"PrizmDoc:CloudApiKey\" configuration setting. " + "Visit https://cloud.accusoft.com to sign up for an account and get an API key at no cost. " + "See the README.md for more information."); } } if (!response.IsSuccessStatusCode) { throw new Exception("Unexpected response when testing the connection to PAS. Are you sure your \"PrizmDoc:PasBaseUrl\" configuration setting is correct? " + "See the README.md for more information."); } // Test PUT /SourceFile, for the self-hosted case, to make sure the secret key will work var viewingSessionId = (string)JObject.Parse(json)["viewingSessionId"]; var route = $"ViewingSession/u{viewingSessionId}/SourceFile?FileExtension=txt"; var content = new StringContent("test"); content.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream"); response = await pasHttpClient.PutAsync(route, content); json = await response.Content.ReadAsStringAsync(); errorCode = null; if (!response.IsSuccessStatusCode) { // Parse the JSON errorCode, if present try { errorCode = (string)JObject.Parse(json)["errorCode"]; } catch (JsonReaderException) { // Ignore JSON parsing errors. errorCode will remain null. } } if (response.StatusCode == HttpStatusCode.Forbidden && errorCode == "InvalidSecret") { var valueSet = configuration["PrizmDoc:PasSecretKey"] != null; if (valueSet) { throw new Exception("Invalid PAS secret. Make sure your \"PrizmDoc:PasSecret\" configuration value matches the \"secretKey\" value in your PAS config file. " + "See the README.md for more information."); } else { throw new Exception("You appear to be using a self-hosted PAS instance, but you have not provided a \"PrizmDoc:PasSecret\" configuration setting. " + "When self-hosting PAS, certain requests require an \"Accusoft-Secret\" header in order to be accepted. " + "To ensure this header is correctly sent, make sure to provide a \"PrizmDoc:PasSecret\" configuration value " + "which matches the \"secretKey\" value in your PAS config file. " + "See the README.md for more information."); } } if (!response.IsSuccessStatusCode) { throw new Exception("Unexpected response when testing the connection to PAS. " + "Have you configured the connection to PAS (PrizmDoc Application Services) correctly? " + "See the README.md for more information."); } }