// 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.");
}
// Create a one-off HTTP client we'll use just to test the configuration.
var pasHttpClient = new HttpClient();
PasUtil.ConfigureHttpClientForPas(pasHttpClient, configuration);
// Test POST /ViewingSession to see whether the configuration will work or not
var response = await pasHttpClient.PostAsync("ViewingSession", new StringContent(JsonConvert.SerializeObject(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.");
}
}