mirror of
https://github.com/asterisk/asterisk.git
synced 2025-09-04 03:50:31 +00:00
5ac65ddfb4
Prior to this patch, when a WebSocket connection is made, ARI would not be informed of the connection until after the WebSocket layer had accepted the connection. This created a brief race condition where the ARI client would be notified that it was connected, a channel would be sent into the Stasis dialplan application, but ARI would not yet have registered the Stasis application presented in the HTTP request that established the WebSocket. This patch resolves this issue by doing the following: * When a WebSocket attempt is made, a callback is made into the ARI application layer, which verifies and registers the apps presented in the HTTP request. Because we do not yet have a WebSocket, we cannot have an event session for the corresponding applications. Some defensive checks were thus added to make the application objects tolerant to a NULL event session. * When a WebSocket connection is made, the registered application is updated with the newly created event session that wraps the WebSocket connection. ASTERISK-24988 #close Reported by: Joshua Colp Change-Id: Ia5dc60dc2b6bee76cd5aff0f69dd53b36e83f636
127 lines
3.1 KiB
Plaintext
127 lines
3.1 KiB
Plaintext
{{#api_declaration}}
|
|
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* {{{copyright}}}
|
|
*
|
|
* {{{author}}}
|
|
*
|
|
* See http://www.asterisk.org for more information about
|
|
* the Asterisk project. Please do not directly contact
|
|
* any of the maintainers of this project for assistance;
|
|
* the project provides a web site, mailing lists and IRC
|
|
* channels for your use.
|
|
*
|
|
* This program is free software, distributed under the terms of
|
|
* the GNU General Public License Version 2. See the LICENSE file
|
|
* at the top of the source tree.
|
|
*/
|
|
|
|
/*! \file
|
|
*
|
|
* \brief Generated file - declares stubs to be implemented in
|
|
* res/ari/resource_{{name}}.c
|
|
*
|
|
* {{{description}}}
|
|
*
|
|
* \author {{{author}}}
|
|
*/
|
|
|
|
/*
|
|
{{> do-not-edit}}
|
|
* This file is generated by a mustache template. Please see the original
|
|
* template in rest-api-templates/ari_resource.h.mustache
|
|
*/
|
|
|
|
#ifndef _ASTERISK_RESOURCE_{{name_caps}}_H
|
|
#define _ASTERISK_RESOURCE_{{name_caps}}_H
|
|
|
|
#include "asterisk/ari.h"
|
|
|
|
{{#apis}}
|
|
{{#operations}}
|
|
/*! Argument struct for ast_ari_{{c_name}}_{{c_nickname}}() */
|
|
struct ast_ari_{{c_name}}_{{c_nickname}}_args {
|
|
{{#parameters}}
|
|
{{#description}}
|
|
{{/description}}
|
|
{{^allow_multiple}}
|
|
{{#description}}
|
|
/*! {{{description}}} */
|
|
{{/description}}
|
|
{{c_data_type}}{{c_space}}{{c_name}};
|
|
{{/allow_multiple}}
|
|
{{#allow_multiple}}
|
|
/*! Array of {{{description}}} */
|
|
{{c_data_type}}{{c_space}}*{{c_name}};
|
|
/*! Length of {{c_name}} array. */
|
|
size_t {{c_name}}_count;
|
|
/*! Parsing context for {{c_name}}. */
|
|
char *{{c_name}}_parse;
|
|
{{/allow_multiple}}
|
|
{{/parameters}}
|
|
};
|
|
{{#is_req}}
|
|
{{#parse_body}}
|
|
/*!
|
|
* \brief Body parsing function for {{path}}.
|
|
* \param body The JSON body from which to parse parameters.
|
|
* \param[out] args The args structure to parse into.
|
|
* \retval zero on success
|
|
* \retval non-zero on failure
|
|
*/
|
|
int ast_ari_{{c_name}}_{{c_nickname}}_parse_body(
|
|
struct ast_json *body,
|
|
struct ast_ari_{{c_name}}_{{c_nickname}}_args *args);
|
|
|
|
{{/parse_body}}
|
|
/*!
|
|
* \brief {{summary}}
|
|
{{#notes}}
|
|
*
|
|
* {{{notes}}}
|
|
{{/notes}}
|
|
*
|
|
* \param headers HTTP headers
|
|
* \param args Swagger parameters
|
|
* \param[out] response HTTP response
|
|
*/
|
|
void ast_ari_{{c_name}}_{{c_nickname}}(struct ast_variable *headers, struct ast_ari_{{c_name}}_{{c_nickname}}_args *args, struct ast_ari_response *response);
|
|
{{/is_req}}
|
|
{{#is_websocket}}
|
|
|
|
/*!
|
|
* \brief {{summary}}
|
|
{{#notes}}
|
|
*
|
|
* {{{notes}}}
|
|
{{/notes}}
|
|
*
|
|
* \param ser HTTP TCP/TLS Server Session
|
|
* \param headers HTTP headers
|
|
* \param args Swagger parameters
|
|
*
|
|
* \retval 0 success
|
|
* \retval non-zero error
|
|
*/
|
|
int ast_ari_websocket_{{c_name}}_{{c_nickname}}_attempted(struct ast_tcptls_session_instance *ser, struct ast_variable *headers, struct ast_ari_{{c_name}}_{{c_nickname}}_args *args);
|
|
|
|
/*!
|
|
* \brief {{summary}}
|
|
{{#notes}}
|
|
*
|
|
* {{{notes}}}
|
|
{{/notes}}
|
|
*
|
|
* \param session ARI WebSocket.
|
|
* \param headers HTTP headers.
|
|
* \param args Swagger parameters.
|
|
*/
|
|
void ast_ari_websocket_{{c_name}}_{{c_nickname}}_established(struct ast_ari_websocket_session *session, struct ast_variable *headers, struct ast_ari_{{c_name}}_{{c_nickname}}_args *args);
|
|
{{/is_websocket}}
|
|
{{/operations}}
|
|
{{/apis}}
|
|
|
|
#endif /* _ASTERISK_RESOURCE_{{name_caps}}_H */
|
|
{{/api_declaration}}
|