/// <summary> /// Gets a reference to a blob in this container. /// </summary> /// <param name="blobName">A string containing the name of the blob.</param> /// <param name="snapshotTime">A <see cref="DateTimeOffset"/> specifying the snapshot timestamp, if the blob is a snapshot.</param> /// <returns>A <see cref="CloudBlob"/> object.</returns> public virtual CloudBlob GetBlobReference(string blobName, DateTimeOffset?snapshotTime) { CommonUtility.AssertNotNullOrEmpty("blobName", blobName); return(new CloudBlob(blobName, snapshotTime, this)); }
/// <summary> /// Returns a reference to a <see cref="CloudBlobContainer"/> object with the specified name. /// </summary> /// <param name="containerName">A string containing the name of the container.</param> /// <returns>A <see cref="CloudBlobContainer"/> object.</returns> public CloudBlobContainer GetContainerReference(string containerName) { CommonUtility.AssertNotNullOrEmpty("containerName", containerName); return(new CloudBlobContainer(containerName, this)); }
/// <summary> /// Gets a reference to the specified table. /// </summary> /// <param name="tableName">A string containing the name of the table.</param> /// <returns>A <see cref="CloudTable"/> object.</returns> public CloudTable GetTableReference(string tableName) { CommonUtility.AssertNotNullOrEmpty("tableName", tableName); return(new CloudTable(tableName, this)); }
/// <summary> /// Adds the metadata. /// </summary> /// <param name="request">The request.</param> /// <param name="name">The metadata name.</param> /// <param name="value">The metadata value.</param> internal static void AddMetadata(HttpWebRequest request, string name, string value) { CommonUtility.AssertNotNullOrEmpty("value", value); request.Headers.Add("x-ms-meta-" + name, value); }
/// <summary> /// Returns a reference to a <see cref="CloudQueue"/> object with the specified name. /// </summary> /// <param name="queueName">A string containing the name of the queue.</param> /// <returns>A <see cref="CloudQueue"/> object.</returns> public virtual CloudQueue GetQueueReference(string queueName) { CommonUtility.AssertNotNullOrEmpty("queueName", queueName); return(new CloudQueue(queueName, this)); }
/// <summary> /// Get the signature hash embedded inside the Shared Access Signature. /// </summary> /// <param name="policy">The shared access policy to hash.</param> /// <param name="accessPolicyIdentifier">An optional identifier for the policy.</param> /// <param name="startPartitionKey">The start partition key, or <c>null</c>.</param> /// <param name="startRowKey">The start row key, or <c>null</c>.</param> /// <param name="endPartitionKey">The end partition key, or <c>null</c>.</param> /// <param name="endRowKey">The end row key, or <c>null</c>.</param> /// <param name="resourceName">The canonical resource string, unescaped.</param> /// <param name="sasVersion">A string indicating the desired SAS version to use, in storage service version format.</param> /// <param name="protocols">The HTTP/HTTPS protocols for Account SAS.</param> /// <param name="ipAddressOrRange">The IP range for IPSAS.</param> /// <param name="keyValue">The key value retrieved as an atomic operation used for signing.</param> /// <returns>The signed hash.</returns> internal static string GetHash( SharedAccessTablePolicy policy, string accessPolicyIdentifier, string startPartitionKey, string startRowKey, string endPartitionKey, string endRowKey, string resourceName, string sasVersion, SharedAccessProtocol?protocols, IPAddressOrRange ipAddressOrRange, byte[] keyValue) { CommonUtility.AssertNotNullOrEmpty("resourceName", resourceName); CommonUtility.AssertNotNull("keyValue", keyValue); CommonUtility.AssertNotNullOrEmpty("sasVersion", sasVersion); string permissions = null; DateTimeOffset?startTime = null; DateTimeOffset?expiryTime = null; if (policy != null) { permissions = SharedAccessTablePolicy.PermissionsToString(policy.Permissions); startTime = policy.SharedAccessStartTime; expiryTime = policy.SharedAccessExpiryTime; } //// StringToSign = signedpermissions + "\n" + //// signedstart + "\n" + //// signedexpiry + "\n" + //// canonicalizedresource + "\n" + //// signedidentifier + "\n" + //// signedIP + "\n" + //// signedProtocol + "\n" + //// signedversion + "\n" + //// startpk + "\n" + //// startrk + "\n" + //// endpk + "\n" + //// endrk //// //// HMAC-SHA256(UTF8.Encode(StringToSign)) //// string stringToSign = string.Format( CultureInfo.InvariantCulture, "{0}\n{1}\n{2}\n{3}\n{4}\n{5}\n{6}\n{7}\n{8}\n{9}\n{10}\n{11}", permissions, GetDateTimeOrEmpty(startTime), GetDateTimeOrEmpty(expiryTime), resourceName, accessPolicyIdentifier, ipAddressOrRange == null ? string.Empty : ipAddressOrRange.ToString(), GetProtocolString(protocols), sasVersion, startPartitionKey, startRowKey, endPartitionKey, endRowKey); Logger.LogVerbose(null /* operationContext */, SR.TraceStringToSign, stringToSign); return(CryptoUtility.ComputeHmac256(keyValue, stringToSign)); }
/// <summary> /// Get the signature hash embedded inside the Shared Access Signature. /// </summary> /// <param name="policy">The shared access policy to hash.</param> /// <param name="headers">The optional header values to set for a file returned with this SAS.</param> /// <param name="accessPolicyIdentifier">An optional identifier for the policy.</param> /// <param name="resourceName">The canonical resource string, unescaped.</param> /// <param name="sasVersion">A string indicating the desired SAS version to use, in storage service version format.</param> /// <param name="protocols">The HTTP/HTTPS protocols for Account SAS.</param> /// <param name="ipAddressOrRange">The IP range for IPSAS.</param> /// <param name="keyValue">The key value retrieved as an atomic operation used for signing.</param> /// <returns>The signed hash.</returns> internal static string GetHash( SharedAccessFilePolicy policy, SharedAccessFileHeaders headers, string accessPolicyIdentifier, string resourceName, string sasVersion, SharedAccessProtocol?protocols, IPAddressOrRange ipAddressOrRange, byte[] keyValue) { CommonUtility.AssertNotNullOrEmpty("resourceName", resourceName); CommonUtility.AssertNotNull("keyValue", keyValue); CommonUtility.AssertNotNullOrEmpty("sasVersion", sasVersion); string permissions = null; DateTimeOffset?startTime = null; DateTimeOffset?expiryTime = null; if (policy != null) { permissions = SharedAccessFilePolicy.PermissionsToString(policy.Permissions); startTime = policy.SharedAccessStartTime; expiryTime = policy.SharedAccessExpiryTime; } //// StringToSign = signedpermissions + "\n" + //// signedstart + "\n" + //// signedexpiry + "\n" + //// canonicalizedresource + "\n" + //// signedidentifier + "\n" + //// signedIP + "\n" + //// signedProtocol + "\n" + //// signedversion + "\n" + //// cachecontrol + "\n" + //// contentdisposition + "\n" + //// contentencoding + "\n" + //// contentlanguage + "\n" + //// contenttype //// //// HMAC-SHA256(UTF8.Encode(StringToSign)) //// string cacheControl = null; string contentDisposition = null; string contentEncoding = null; string contentLanguage = null; string contentType = null; if (headers != null) { cacheControl = headers.CacheControl; contentDisposition = headers.ContentDisposition; contentEncoding = headers.ContentEncoding; contentLanguage = headers.ContentLanguage; contentType = headers.ContentType; } string stringToSign = string.Format( CultureInfo.InvariantCulture, "{0}\n{1}\n{2}\n{3}\n{4}\n{5}\n{6}\n{7}\n{8}\n{9}\n{10}\n{11}\n{12}", permissions, GetDateTimeOrEmpty(startTime), GetDateTimeOrEmpty(expiryTime), resourceName, accessPolicyIdentifier, ipAddressOrRange == null ? string.Empty : ipAddressOrRange.ToString(), GetProtocolString(protocols), sasVersion, cacheControl, contentDisposition, contentEncoding, contentLanguage, contentType); Logger.LogVerbose(null /* operationContext */, SR.TraceStringToSign, stringToSign); return(CryptoUtility.ComputeHmac256(keyValue, stringToSign)); }
internal IAsyncOperation <TableResult> ExecuteAsync(CloudTableClient client, string tableName, TableRequestOptions requestOptions, OperationContext operationContext) #endif { TableRequestOptions modifiedOptions = TableRequestOptions.ApplyDefaults(requestOptions, client); operationContext = operationContext ?? new OperationContext(); CommonUtility.AssertNotNullOrEmpty("tableName", tableName); RESTCommand <TableResult> cmdToExecute = null; if (this.OperationType == TableOperationType.Insert || this.OperationType == TableOperationType.InsertOrMerge || this.OperationType == TableOperationType.InsertOrReplace) { if (!this.isTableEntity && this.OperationType != TableOperationType.Insert) { CommonUtility.AssertNotNull("Upserts require a valid PartitionKey", this.Entity.PartitionKey); CommonUtility.AssertNotNull("Upserts require a valid RowKey", this.Entity.RowKey); } cmdToExecute = InsertImpl(this, client, tableName, modifiedOptions); } else if (this.OperationType == TableOperationType.Delete) { if (!this.isTableEntity) { CommonUtility.AssertNotNullOrEmpty("Delete requires a valid ETag", this.Entity.ETag); CommonUtility.AssertNotNull("Delete requires a valid PartitionKey", this.Entity.PartitionKey); CommonUtility.AssertNotNull("Delete requires a valid RowKey", this.Entity.RowKey); } cmdToExecute = DeleteImpl(this, client, tableName, modifiedOptions); } else if (this.OperationType == TableOperationType.Merge) { CommonUtility.AssertNotNullOrEmpty("Merge requires a valid ETag", this.Entity.ETag); CommonUtility.AssertNotNull("Merge requires a valid PartitionKey", this.Entity.PartitionKey); CommonUtility.AssertNotNull("Merge requires a valid RowKey", this.Entity.RowKey); cmdToExecute = MergeImpl(this, client, tableName, modifiedOptions); } else if (this.OperationType == TableOperationType.Replace) { CommonUtility.AssertNotNullOrEmpty("Replace requires a valid ETag", this.Entity.ETag); CommonUtility.AssertNotNull("Replace requires a valid PartitionKey", this.Entity.PartitionKey); CommonUtility.AssertNotNull("Replace requires a valid RowKey", this.Entity.RowKey); cmdToExecute = ReplaceImpl(this, client, tableName, modifiedOptions); } else if (this.OperationType == TableOperationType.Retrieve) { cmdToExecute = RetrieveImpl(this, client, tableName, modifiedOptions); } else { throw new NotSupportedException(); } #if ASPNET_K || PORTABLE return(Task.Run(() => Executor.ExecuteAsync( cmdToExecute, modifiedOptions.RetryPolicy, operationContext, cancellationToken), cancellationToken)); #else return(AsyncInfo.Run((cancellationToken) => Executor.ExecuteAsync( cmdToExecute, modifiedOptions.RetryPolicy, operationContext, cancellationToken))); #endif }
/// <summary> /// Returns a reference to a <see cref="CloudFileShare"/> object with the specified name. /// </summary> /// <param name="shareName">A string containing the name of the share.</param> /// <returns>A reference to a share.</returns> public CloudFileShare GetShareReference(string shareName) { CommonUtility.AssertNotNullOrEmpty("shareName", shareName); return(new CloudFileShare(shareName, this)); }
internal static string GetHash( SharedAccessBlobPolicy policy, SharedAccessBlobHeaders headers, string accessPolicyIdentifier, string resourceName, string sasVersion, byte[] keyValue) { CommonUtility.AssertNotNullOrEmpty("resourceName", resourceName); CommonUtility.AssertNotNull("keyValue", keyValue); CommonUtility.AssertNotNullOrEmpty("sasVersion", sasVersion); string permissions = null; DateTimeOffset?startTime = null; DateTimeOffset?expiryTime = null; if (policy != null) { permissions = SharedAccessBlobPolicy.PermissionsToString(policy.Permissions); startTime = policy.SharedAccessStartTime; expiryTime = policy.SharedAccessExpiryTime; } //// StringToSign = signedpermissions + "\n" + //// signedstart + "\n" + //// signedexpiry + "\n" + //// canonicalizedresource + "\n" + //// signedidentifier + "\n" + //// signedversion + "\n" + //// cachecontrol + "\n" + //// contentdisposition + "\n" + //// contentencoding + "\n" + //// contentlanguage + "\n" + //// contenttype //// //// HMAC-SHA256(UTF8.Encode(StringToSign)) //// //// Note that the final five headers are invalid for the 2012-02-12 version. string stringToSign = string.Format( CultureInfo.InvariantCulture, "{0}\n{1}\n{2}\n{3}\n{4}\n{5}", permissions, GetDateTimeOrEmpty(startTime), GetDateTimeOrEmpty(expiryTime), resourceName, accessPolicyIdentifier, sasVersion); if (string.Equals(sasVersion, Constants.VersionConstants.February2012)) { if (headers != null) { string errorString = string.Format(CultureInfo.CurrentCulture, SR.InvalidHeaders); throw new ArgumentException(errorString); } } else { string cacheControl = null; string contentDisposition = null; string contentEncoding = null; string contentLanguage = null; string contentType = null; if (headers != null) { cacheControl = headers.CacheControl; contentDisposition = headers.ContentDisposition; contentEncoding = headers.ContentEncoding; contentLanguage = headers.ContentLanguage; contentType = headers.ContentType; } stringToSign = stringToSign + string.Format( CultureInfo.InvariantCulture, "\n{0}\n{1}\n{2}\n{3}\n{4}", cacheControl, contentDisposition, contentEncoding, contentLanguage, contentType); } return(CryptoUtility.ComputeHmac256(keyValue, stringToSign)); }
/// <summary> /// Get the signature hash embedded inside the User Delegation Shared Access Signature. /// </summary> /// <param name="policy">The shared access policy to hash.</param> /// <param name="headers">The optional header values to set for a blob returned with this SAS.</param> /// <param name="resourceName">The canonical resource string, unescaped.</param> /// <param name="sasVersion">A string indicating the desired SAS version to use, in storage service version format.</param> /// <param name="resourceIdentifier">Resource type id string.</param> /// <param name="snapTime">Time of snapshot if applicable.</param> /// <param name="protocols">The HTTP/HTTPS protocols for Account SAS.</param> /// <param name="ipAddressOrRange">The IP range for IPSAS.</param> /// <param name="delegationKey">The user delegaion key used for signing.</param> /// <returns>The signed hash.</returns> internal static string GetHash( SharedAccessBlobPolicy policy, SharedAccessBlobHeaders headers, string resourceName, string sasVersion, string resourceIdentifier, DateTimeOffset?snapTime, SharedAccessProtocol?protocols, IPAddressOrRange ipAddressOrRange, UserDelegationKey delegationKey) { CommonUtility.AssertNotNullOrEmpty("resourceName", resourceName); CommonUtility.AssertNotNullOrEmpty("sasVersion", sasVersion); CommonUtility.AssertNotNull("delegationKey", delegationKey); CommonUtility.AssertNotNull("delegationKey.SignedOid", delegationKey.SignedOid); CommonUtility.AssertNotNull("delegationKey.SignedTid", delegationKey.SignedTid); CommonUtility.AssertNotNull("delegationKey.SignedStart", delegationKey.SignedStart); CommonUtility.AssertNotNull("delegationKey.SignedExpiry", delegationKey.SignedExpiry); CommonUtility.AssertNotNullOrEmpty("delegationKey.SignedService", delegationKey.SignedService); CommonUtility.AssertNotNullOrEmpty("delegationKey.SignedVersion", delegationKey.SignedVersion); CommonUtility.AssertNotNullOrEmpty("delegationKey.Value", delegationKey.Value); CommonUtility.AssertNotNull("policy", policy); CommonUtility.AssertNotNull("policy.SharedAccessExpiryTime", policy.SharedAccessExpiryTime); CommonUtility.AssertNotNullOrEmpty("policy.Permissions", SharedAccessBlobPolicy.PermissionsToString(policy.Permissions)); string permissions = SharedAccessBlobPolicy.PermissionsToString(policy.Permissions); DateTimeOffset?startTime = policy.SharedAccessStartTime; DateTimeOffset?expiryTime = policy.SharedAccessExpiryTime; //// StringToSign = signedpermissions + "\n" + //// signedstart + "\n" + //// signedexpiry + "\n" + //// canonicalizedresource + "\n" + //// signedoid + "\n" + //// signedtid + "\n" + //// signedkeystart + "\n" + //// signedkeyexpiry + "\n" + //// signedkeyservice + "\n" + //// signedkeyverion + "\n" + //// signedIP + "\n" + //// signedProtocol + "\n" + //// signedversion + "\n" + //// signedResourceIdentifier + "\n" + //// signedTimeStamp + "\n" + //// cachecontrol + "\n" + //// contentdisposition + "\n" + //// contentencoding + "\n" + //// contentlanguage + "\n" + //// contenttype //// //// HMAC-SHA256(UTF8.Encode(StringToSign)) string cacheControl = null; string contentDisposition = null; string contentEncoding = null; string contentLanguage = null; string contentType = null; if (headers != null) { cacheControl = headers.CacheControl; contentDisposition = headers.ContentDisposition; contentEncoding = headers.ContentEncoding; contentLanguage = headers.ContentLanguage; contentType = headers.ContentType; } string stringToSign = string.Format( CultureInfo.InvariantCulture, "{0}\n{1}\n{2}\n{3}\n{4}\n{5}\n{6}\n{7}\n{8}\n{9}\n{10}\n{11}\n{12}\n{13}\n{14}\n{15}\n{16}\n{17}\n{18}\n{19}", permissions, SharedAccessSignatureHelper.GetDateTimeOrEmpty(startTime), SharedAccessSignatureHelper.GetDateTimeOrEmpty(expiryTime), resourceName, delegationKey.SignedOid, delegationKey.SignedTid, delegationKey.SignedStart.Value.UtcDateTime.ToString(Constants.DateTimeFormatter), delegationKey.SignedExpiry.Value.UtcDateTime.ToString(Constants.DateTimeFormatter), delegationKey.SignedService, delegationKey.SignedVersion, ipAddressOrRange == null ? string.Empty : ipAddressOrRange.ToString(), SharedAccessSignatureHelper.GetProtocolString(protocols), sasVersion, resourceIdentifier, snapTime.ToString(), cacheControl, contentDisposition, contentEncoding, contentLanguage, contentType); Logger.LogVerbose(null /* operationContext */, SR.TraceStringToSign, stringToSign); return(CryptoUtility.ComputeHmac256(Convert.FromBase64String(delegationKey.Value), stringToSign)); }
internal static string GetHash( SharedAccessBlobPolicy policy, SharedAccessBlobHeaders headers, string accessPolicyIdentifier, string resourceName, byte[] keyValue) { CommonUtility.AssertNotNullOrEmpty("resourceName", resourceName); CommonUtility.AssertNotNull("keyValue", keyValue); string permissions = null; DateTimeOffset?startTime = null; DateTimeOffset?expiryTime = null; if (policy != null) { permissions = SharedAccessBlobPolicy.PermissionsToString(policy.Permissions); startTime = policy.SharedAccessStartTime; expiryTime = policy.SharedAccessExpiryTime; } string cacheControl = null; string contentDisposition = null; string contentEncoding = null; string contentLanguage = null; string contentType = null; if (headers != null) { cacheControl = headers.CacheControl; contentDisposition = headers.ContentDisposition; contentEncoding = headers.ContentEncoding; contentLanguage = headers.ContentLanguage; contentType = headers.ContentType; } //// StringToSign = signedpermissions + "\n" + //// signedstart + "\n" + //// signedexpiry + "\n" + //// canonicalizedresource + "\n" + //// signedidentifier + "\n" + //// signedversion + "\n" + //// cachecontrol + "\n" + //// contentdisposition + "\n" + //// contentencoding + "\n" + //// contentlanguage + "\n" + //// contenttype //// //// HMAC-SHA256(UTF8.Encode(StringToSign)) string stringToSign = string.Format( CultureInfo.InvariantCulture, "{0}\n{1}\n{2}\n{3}\n{4}\n{5}\n{6}\n{7}\n{8}\n{9}\n{10}", permissions, GetDateTimeOrEmpty(startTime), GetDateTimeOrEmpty(expiryTime), resourceName, accessPolicyIdentifier, Constants.HeaderConstants.TargetStorageVersion, cacheControl, contentDisposition, contentEncoding, contentLanguage, contentType); return(CryptoUtility.ComputeHmac256(keyValue, stringToSign)); }